Request an upload session for a portal image

Starts an upload for the portal's favicon, logo or cover image. Returns where to send the bytes and a session id to pass to the portal settings update.

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Body

application/json

fileNamestringrequired

Name to store the file under, 1 to 250 characters.

example: notice.pdf

fileSizeintegerrequired

Size of the file in bytes. Must be at least 1.

example: 84213

contentTypestringrequired

MIME type of the file, 1 to 200 characters.

example: application/pdf

Response

200 · Where to send the image bytes.

sessionIdstring

The upload session. Hand this id back to the endpoint that attaches the file once the bytes are uploaded. A Snowflake id sent as a decimal string.

endpointstring

Absolute URL to send the file bytes to.

methodstring

HTTP method to use when sending the bytes, for example POST.

fieldsobject

Form fields that must accompany the upload, as a name to value map. Send them as multipart/form-data together with the file itself.

expiresstring · date-time

When the session stops accepting an upload, in the company's timezone.

401 · The access token is missing, expired, or not valid for this company.

How uploading works

Attaching a file takes three calls.

Ask for an upload session here. You get back an endpoint, a method, and a map of fields.
Send the bytes to that endpoint as multipart/form-data, including every entry in fields plus the file itself.
Call PUT /company-app/companies/portal-settings with the sessionId in iconUploadSessionId, logoUploadSessionId or coverUploadSessionId.

The session stops working at expires. A session whose file is never attached is discarded.

One session becomes one image. Which of the three settings fields you put the session id in decides whether it becomes the favicon, the logo or the cover.