ANando
Files

Create a file

Changed on

Creates a file upload intent for a message attachment. The response returns temporary direct storage upload instructions; send the bytes to that URL, then complete the file before using its id in create-message file_ids. Replay the same request with the same Idempotency-Key and body to refresh an active upload URL.

post/files

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/files
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Headers

Idempotency-Keystring required

Idempotency key.

Required idempotency key for safely retrying this write.

Request body

client_upload_idstring nullable

Optional caller-generated identifier for correlating this file with the integration's local upload.

content_typestring required

Declared MIME content type.

filenamestring required

Original filename.

purpose'message_attachment'

File purpose.

sha256string nullable

Optional lowercase hex-encoded SHA-256 digest of the file bytes. SHA-256 verification is supported only when size_bytes is less than or equal to 67108864.

size_bytesinteger required

Declared file size in bytes.

Response

Existing file upload intent for a matching idempotency key.

file_idstring required

File identifier. Matches data.id.

Example response

{
  "data": {
    "created_at": "2026-05-14T08:00:00.000Z",
    "file_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "updated_at": "2026-05-14T08:00:00.000Z",
    "upload": {
      "expires_at": "2026-05-14T08:00:00.000Z"
    }
  },
  "file_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
}

Changes

  • aaceae49c08dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • a9b29e0cf8fdRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status