andibase Overview Get started (for AI Agents)Apps Authentication Building Blocks Data Model Introduction

Api reference

List my workspaces GET Create workspace POST List workspace API keys GET Create workspace API key POST Create workspace user POST Invite user to workspace POST Delete workspace API key DELETE

List workspace apps GET Get public app GET Issue embedded app runtime token POST Create app POST Update app PATCH Delete app DELETE

List workspace files GET Create file POST Presign multipart parts POST Complete file upload POST

Data Definitions

List data definitions GET Get data definition GET Create data definition POST Update data definition PATCH Delete data definition DELETE

List data GET Get data by id GET Upsert many data rows POST Patch many data rows PATCH Delete many data rows POST

Start agent login POST Get agent login request GET Approve agent login POST Deny agent login POST Exchange agent login POST

List workspace agents GET Get workspace agent GET List agent chats GET Get agent chat GET Send agent message POST Create workspace agent POST Update workspace agent PATCH Delete workspace agent DELETE

List channels GET Create channel POST Get channel GET

List explorer nodes GET List explorer folders GET Create folder POST Move explorer node POST Rename explorer folder PATCH Delete explorer folder DELETE

List workspace intakes GET Create workspace intake POST List workspace intake logs GET Ingest a public intake event POST

List channel messages GET Create channel message POST List thread messages GET Create thread message POST

List workspace sessions GET Get workspace session GET Create workspace session POST Create workspace session event POST List workspace session events GET

List channel threads GET Create thread POST Get thread GET

Api reference

Agents

Available Methods

Use the links below to view request/response examples and generated code for each method.

GET
/api/v1/experimental/agents
List workspace agents
GET
/api/v1/experimental/agents/{handle}
Get workspace agent
GET
/api/v1/experimental/agents/{handle}/chats
List agent chats
GET
/api/v1/experimental/agents/{handle}/chats/{chatId}
Get agent chat
POST
/api/v1/experimental/agents/{handle}/chats/{chatId}/messages
Send agent message
POST
/api/v1/experimental/agents
Create workspace agent
PATCH
/api/v1/experimental/agents/{handle}
Update workspace agent
DELETE
/api/v1/experimental/agents/{handle}
Delete workspace agent

Exchange agent login POST

Polls the agent login request using deviceCode and, once approved, issues a reusable workspace-scoped API key. The secret is returned once at apiKey.key, should be saved immediately, and should be reused for future HTTP API calls instead of re-running login.

List workspace agents GET

Lists agents for the resolved workspace. Session requests must send x-workspace-handle or x-workspace-id when the user has access to multiple workspaces.