Skip to navigation

Create an internal resource

View as Markdown

Create a new internal resource. Send the file either as a base64 data URI in file or as the URL that POST /api/core/private/v1alpha/files/ returned for private=true in fileUrl. Only a privately staged upload is accepted in fileUrl; a public upload URL is refused. The staged file must be an image (JPEG, PNG, SVG, WebP, GIF) or a PDF of at most 4 MB; it is copied into the resource’s protected storage and the staged copy is removed. file wins when both are sent: a well-formed fileUrl is then ignored without being checked (a malformed one is still refused). A resource needs either url or a file: send url: null with fileUrl to replace a link with a file.

Authentication

AuthorizationToken

Your API key, sent as Authorization: Token <your API key>

Path parameters

directoryIdstringRequiredformat: "uuid"
id of the directory
entryIdstringRequiredformat: "uuid"
id of the Partner entry

Request

This endpoint expects an object.
fileUrlstring or nullOptionalformat: "uri">=1 character
titlestring or nullOptional1-255 characters
filestring or nullOptionalformat: "binary"
urlstring or nullOptionalformat: "uri"1-2000 characters
orderintegerOptional>=0

Response

Successful operation
idstringformat: "uuid"
titlestring or nullOptional<=255 characters
filestring or nullOptional
fileUrlstring or nullOptional
urlstring or nullOptionalformat: "uri"<=2000 characters
orderintegerOptional>=0

Errors

400
Bad Request Error
404
Not Found Error