Request an upload session for a notice attachment

Starts an upload for a file you want to attach to a violation notice sent to the tenants or to the owners. Returns where to send the bytes and a session id for the notice call.

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.

Path parameters

violationIdstringrequired

The association violation to act on. A Snowflake id sent as a decimal string.

example: 1830472847398407007

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 file 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.

404 · No association violation with that id exists in the caller's 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.
Send the notice, putting the sessionId into chatAttachmentSessionIds or emailAttachmentSessionIds.

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

Chat attachments and email attachments both come from sessions requested here. Which of the two lists you put the session id in decides where the file ends up.