Files and media

List files

GET

https://<domain-anda>

/api/v1/public/files

Return the files stored in the File Center, newest first.

Returns the workspace File Center: images, documents, videos and audio the team uploaded for sending to customers or for the AI to attach, with each file purpose and description. Use it to find a file before attaching it to a message. Archived files are not listed. Read-only. Paginated: follow meta.pagination.nextCursor until hasMore is false.

List files › query Parameters

limit

integer · min: 1 · max: 100

Rows to return, 1-100. Defaults to 25.

cursor

string

The meta.pagination.nextCursor value from the previous call. Omit it to read the first page.

q

string

Match against the file name, case-insensitive.

type

string · enum

Only this kind of file: image, document, video or audio.

Enum values:

image

document

video

audio

List files › Responses

The API key is missing, malformed, expired, or its owner is inactive.

Error

success

required

object · required

Resolve a file to its URL

GET

https://<domain-anda>

/api/v1/public/files/{id}/resolve

Return the public URL, type and name of one File Center file.

Looks up one file by id and returns the URL to attach to an outgoing message, plus its type, name and mime type. Use it after files.list to turn a file id into something the messages.* operations can send. Read-only; it sends nothing.

Resolve a file to its URL › path Parameters

id

string · required

File id from files.list.

Resolve a file to its URL › Responses

The API key is missing, malformed, expired, or its owner is inactive.

Error

success

required

object · required

Archive a file

DELETE

https://<domain-anda>

/api/v1/public/files/{id}

Remove a file from the File Center.

Archives a File Center file so it disappears from files.list and can no longer be picked for new messages. Messages already sent are unaffected. There is no public operation to restore it, so confirm with the user first.

Archive a file › path Parameters

id

string · required

File id from files.list.

Archive a file › Responses

The API key is missing, malformed, expired, or its owner is inactive.

Error

success

required

object · required

Edit file details

PATCH

https://<domain-anda>

/api/v1/public/files/{id}

Rename a file or change its purpose and description.

Updates the name, purpose or description of a File Center file. The purpose text tells the AI when to attach the file, so editing it changes how the AI answers customers. Send only the fields to change; send null to clear purpose or description. It does not replace the file content and sends nothing.

Edit file details › path Parameters

id

string · required

File id from files.list.

Edit file details › Request Body optional

filename

string

New file name, including its extension.

purpose

string | null

When the AI should attach this file. null clears it.

description

string | null

Free-text note about the file. null clears it.

Edit file details › Responses

The API key is missing, malformed, expired, or its owner is inactive.

Error

success

required

object · required

Look up WhatsApp media

GET

https://<domain-anda>

/api/v1/public/media/{mediaId}

Resolve a WhatsApp media id from an incoming message to its download details.

Asks WhatsApp for the temporary download URL and mime type of a media id that arrived in a message. Use it to read an image or document a customer sent. The URL expires within minutes and needs the workspace WhatsApp token to download, so most agents should read the media URL already on the message instead. Calls Meta, so it is rate limited as expensive. Read-only. Fails if no WhatsApp account is connected.

Look up WhatsApp media › path Parameters

mediaId

string · required

WhatsApp media id taken from a message.

Look up WhatsApp media › Responses

The API key is missing, malformed, expired, or its owner is inactive.

Error

success

required

object · required

Catalog Notifications