Upload an attachment | Ara Documentation

Uploads a file to the organization. Send the file as multipart/form-data in the file field.

_{Scope: attachments:write}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The file to upload.

Response

The created attachment.

idstringOptional

namestringOptional

content_typestringOptional

size_bytesintegerOptional

urlstringOptional

A signed download URL for the file.

created_atdatetimeOptional

Errors

400

Bad Request Error

$	curl -X POST https://api.ara.so/v3/organizations/orgId/attachments \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@company_logo.png

1	{
2	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3	"name": "company_logo.png",
4	"content_type": "image/png",
5	"size_bytes": 24576,
6	"url": "https://cdn.ara.so/attachments/a1b2c3d4-e5f6-7890-ab12-cd34ef567890/download?signature=abc123",
7	"created_at": "2024-01-15T09:30:00Z"
8	}