Skip to main content
POST
Upload an attachment
Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

X-Api-Key
string
required

API key. Refer to Authentication for more information.

Accept
enum<string>
default:application/json
required

Must be application/json.

Available options:
application/json

Body

multipart/form-data
file
file
required

The file to upload.

Response

The uploaded file.

id
string<uuid>

Unique identifier of the uploaded file.

filename
string

Name of the uploaded file.

content_type
string

Media type of the file, such as image/png.

byte_size
integer

Size of the file in bytes.

checksum
string

Base64 MD5 checksum of the file.

key
string

Storage key of the file.

service_name
string

Storage service that holds the file.

metadata
object

Metadata of the file, including the workspace it belongs to.

created_at
string<date-time>

When the file was uploaded.

attachable_sgid
string

Signed global ID of the file.

signed_id
string

Signed reference to the file. Pass it as cover_image_signed_id to the CreateChangelog MCP tool.

blob_url
string

URL that redirects to the file.