Upload a file / attacca docs

Multipart form with fields `session_id`, `filename`, `content_type`, and `file`. The bytes land in the account's Computer workspace under `uploads/` — the agent reads them back with its `computer_file_*` tools, and you download them again with `GET /v1/files/{file_id}/content`. The file is registered against the session it was uploaded to, so it is only reachable (and only readable by an agent working that chat) through a session the key's account owns.

Multipart form with fields session_id, filename, content_type, and file. The bytes land in the account's Computer workspace under uploads/ — the agent reads them back with its computer_file_* tools, and you download them again with GET /v1/files/{file_id}/content.

The file is registered against the session it was uploaded to, so it is only reachable (and only readable by an agent working that chat) through a session the key's account owns.

Authorization

api_key files:write

AuthorizationBearer <token>

An atk_-prefixed API key, created under Settings → API keys.

In: header

Scope: files:write

Request Body

multipart/form-data

Fields: session_id, filename, content_type, file

TypeScript Definitions

Use the request body type in TypeScript.

Multipart fields of POST /v1/files. The file part carries the raw bytes; the other three are plain text form fields. Documented as an object schema so the docs' cURL examples render one -F flag per field — a bare type: string body breaks the multipart example generator.

content_type*string

The file's content type, e.g. text/plain.

file*file

The file bytes.

Formatbinary

filename*string

The file's name, stored under the workspace uploads/.

session_id*string

The session the file is uploaded to.

Formatuuid

Response Body

`application/json`

curl -X POST "https://example.com/v1/files" \  -F content_type="string" \  -F file="string" \  -F filename="string" \  -F session_id="1ffd059c-17ea-40a8-8aef-70fd0307db82"

{  "artifact_key": "string",  "changelog": "string",  "content_type": "string",  "created_at": "2019-08-24T14:15:22Z",  "filename": "string",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "kind": "string",  "path": "string",  "pinned": true,  "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",  "size_bytes": 0,  "title": "string",  "version": 0}

Upload a file

Authorization

Request Body

Response Body

200application/json

400application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`