Skip to main content
POST
CreateFile
API v1 is deprecated and will be removed in the future. Please migrate to API v2 for new features and long-term support.
Creates a file record and returns a presigned URL for uploading the file content to S3. After receiving the upload URL, use a PUT request to upload your file content. The file can then be referenced in task attachments using the returned file_id.

Authorizations

API_KEY
string
header
required

Body

application/json
filename
string
required

Name of the file to upload

Response

200 - application/json

File record created successfully.

id
string

Unique identifier for the file

object
string

Always "file"

filename
string

Name of the file

status
string

Initial status is "pending"

upload_url
string

Presigned S3 URL for uploading the file content (PUT request)

upload_expires_at
string<date-time>

ISO 8601 timestamp when the upload URL expires

created_at
string<date-time>

ISO 8601 timestamp when the file record was created