/api/v1/workspaces/{workspaceId}/knowledge/sites/{siteId}/pages/{pageId}/cover/upload/initiate

Scope knowledge:write

Start a cover image upload. The response includes an upload URL. PUT the image bytes there, then complete the upload. The cover stays on the draft until you publish.

Pfad

siteIdPflicht

string (uuid)

Knowledge site identifier.

pageIdPflicht

string (uuid)

Page identifier.

workspaceIdPflicht

string

Workspace that owns the resource.

Request

application/json · InitiateKnowledgeCoverUploadRequestDto

fileName

string

Name of the file.

contentType

string

Content type.

sizeBytes

integer (int64)

Size bytes.

Antworten

200InitiateKnowledgeCoverUploadResponseDtoThe request succeeded. The JSON body contains url, data, and meta. The linked schema is data.

Initiate knowledge cover upload response.

sessionId

string (uuid)

Identifier of the session.

uploadUrl

string

URL of the upload.

expiresAt

string (date-time)

When this URL or value expires.

400ApiProblemThe request is invalid.

401ApiProblemThe private app token is missing or invalid.

403ApiProblemThe token is missing the required scope, or this action is not allowed.

404ApiProblemThe workspace or resource was not found.

defaultApiProblemError response.