Agents
144 endpoints.
- GET
/api/v1/agents/cardsList agent cards - POST
/api/v1/agents/cards/{card_id}/answerAnswer an agent card - GET
/api/v1/agents/channel/postsRead the Team chat - POST
/api/v1/agents/channel/postsPost to the Team chat - DELETE
/api/v1/agents/channel/posts/{post_id}Delete your Team chat message - GET
/api/v1/agents/channel/posts/{post_id}Get one Team chat post - PATCH
/api/v1/agents/channel/posts/{post_id}Edit your Team chat message - POST
/api/v1/agents/channel/posts/{post_id}/reactionsReact to a Team chat post - DELETE
/api/v1/agents/channel/posts/{post_id}/reactions/{emoji}Remove your reaction from a Team chat post - PUT
/api/v1/agents/channel/readMark the Team chat read - GET
/api/v1/agents/channel/streamStream Team chat hints (SSE) - GET
/api/v1/agents/channel/unreadCount unread Team chat posts - GET
/api/v1/agents/controlsAgent Controls: every subject that can act on this business - GET
/api/v1/agents/enginesEngine status (superuser) - GET
/api/v1/agents/engines/activityAgent runs across every business (superuser) - DELETE
/api/v1/agents/engines/dropboxDisconnect the team Dropbox (superuser) - GET
/api/v1/agents/engines/dropboxTeam Dropbox status (superuser) - PUT
/api/v1/agents/engines/dropbox/appSet the Dropbox app key and secret (superuser) - GET
/api/v1/agents/engines/dropbox/browseBrowse the team Dropbox (superuser) - POST
/api/v1/agents/engines/dropbox/connectStart connecting the team Dropbox (superuser) - GET
/api/v1/agents/engines/dropbox/foldersTeam Dropbox folder mappings (superuser) - POST
/api/v1/agents/engines/dropbox/foldersMap a Dropbox folder (superuser) - DELETE
/api/v1/agents/engines/dropbox/folders/{folder_id}Remove a Dropbox folder mapping (superuser) - GET
/api/v1/agents/engines/dropbox/oauth/callbackTeam Dropbox OAuth callback - GET
/api/v1/agents/engines/mcp-usageExternal MCP servers and agents' use of them (superuser) - GET
/api/v1/agents/engines/runs/{run_id}/eventsRead any business's run transcript (superuser) - GET
/api/v1/agents/engines/spendAgent spend across every business (superuser) - DELETE
/api/v1/agents/engines/{engine}/credentialDisconnect an engine account (superuser) - PUT
/api/v1/agents/engines/{engine}/credentialPaste an engine credential (superuser) - POST
/api/v1/agents/engines/{engine}/sign-inSign an engine in from the worker (superuser) - POST
/api/v1/agents/engines/{engine}/sign-in/cancelCancel an engine sign-in (superuser) - POST
/api/v1/agents/engines/{engine}/sign-in/codePaste the code the browser showed (superuser) - POST
/api/v1/agents/engines/{engine}/testTest an engine's credential (superuser) - GET
/api/v1/agents/firm/overviewEvery client's team (firm roll-up) - GET
/api/v1/agents/libraryList the agent role library and shared procedures - GET
/api/v1/agents/library/{procedure_id}Read a shared procedure - POST
/api/v1/agents/library/{procedure_id}/installInstall a shared procedure - GET
/api/v1/agents/mailAgents Mail Settings - PUT
/api/v1/agents/mailAgents Mail Configure - GET
/api/v1/agents/mail/client/threadsAgents Mail Client Threads - GET
/api/v1/agents/mail/client/threads/{thread_id}Agents Mail Client Thread - GET
/api/v1/agents/mail/client/threads/{thread_id}/messages/{message_id}/attachments/{index}Agents Mail Client Attachment - POST
/api/v1/agents/mail/client/threads/{thread_id}/replyAgents Mail Client Reply - POST
/api/v1/agents/mail/draftsAgents Mail Compose - POST
/api/v1/agents/mail/emails/{email_id}/conversationAgents Mail Open Email - POST
/api/v1/agents/mail/emails/{email_id}/restoreAgents Mail Restore Email - POST
/api/v1/agents/mail/grantsAgents Mail Grant - DELETE
/api/v1/agents/mail/grants/{grant_id}Agents Mail Revoke - GET
/api/v1/agents/mail/inboxAgents Mail Inbox - PUT
/api/v1/agents/mail/inbox/{kind}/{item_id}/categoryAgents Mail Category - GET
/api/v1/agents/mail/messages/{message_id}/attachments/{index}Agents Mail Attachment - POST
/api/v1/agents/mail/messages/{message_id}/sendAgents Mail Send - GET
/api/v1/agents/mail/sendersAgents Mail Senders - GET
/api/v1/agents/mail/senders/{sender_id}Agents Mail Sender - PATCH
/api/v1/agents/mail/senders/{sender_id}Agents Mail Sender Update - POST
/api/v1/agents/mail/senders/{sender_id}/linkAgents Mail Sender Link - PUT
/api/v1/agents/mail/senders/{sender_id}/statusAgents Mail Sender Status - GET
/api/v1/agents/mail/sentAgents Mail Sent - GET
/api/v1/agents/mail/threadsAgents Mail Threads - GET
/api/v1/agents/mail/threads/{thread_id}Agents Mail Thread - POST
/api/v1/agents/mail/threads/{thread_id}/draftsAgents Mail Draft - POST
/api/v1/agents/mail/threads/{thread_id}/startAgents Mail Start - POST
/api/v1/agents/mail/threads/{thread_id}/suggested-replyAgents Mail Suggest Reply - PUT
/api/v1/agents/mail/threads/{thread_id}/takeoverAgents Mail Takeover - GET
/api/v1/agents/mandatesList payment mandates - POST
/api/v1/agents/mandatesPropose a payment mandate - GET
/api/v1/agents/mandates/{mandate_id}Get a payment mandate - GET
/api/v1/agents/mandates/{mandate_id}/ap2Export a mandate as an AP2 v0.2-shaped payment mandate - POST
/api/v1/agents/mandates/{mandate_id}/countersignCounter-sign a proposed mandate - POST
/api/v1/agents/mandates/{mandate_id}/revokeRevoke a payment mandate - GET
/api/v1/agents/mandates/{mandate_id}/usesList a mandate's uses - GET
/api/v1/agents/needs-youWhat agents need from you - GET
/api/v1/agents/proceduresList procedures - POST
/api/v1/agents/proceduresGenerate a procedure draft from SOP text - GET
/api/v1/agents/procedures/{procedure_id}Get a procedure - PATCH
/api/v1/agents/procedures/{procedure_id}Replace a procedure's draft - POST
/api/v1/agents/procedures/{procedure_id}/installInstall a procedure - POST
/api/v1/agents/procedures/{procedure_id}/publishShare a procedure - POST
/api/v1/agents/procedures/{procedure_id}/refreshUpdate a team from its SOP - GET
/api/v1/agents/procedures/{procedure_id}/source-diffCompare a copy with its source - POST
/api/v1/agents/procedures/{procedure_id}/sync-from-sourceUpdate a copy from its source - POST
/api/v1/agents/procedures/{procedure_id}/unpublishStop sharing a procedure - GET
/api/v1/agents/rolesList agent roles - POST
/api/v1/agents/rolesCreate an agent role - DELETE
/api/v1/agents/roles/{role_id}Delete an agent role - GET
/api/v1/agents/roles/{role_id}Get an agent role - PATCH
/api/v1/agents/roles/{role_id}Update an agent role - GET
/api/v1/agents/roles/{role_id}/permission-grantsList a role's always-allowed tools - DELETE
/api/v1/agents/roles/{role_id}/permission-grants/{grant_id}Revoke a role's always-allowed tool - POST
/api/v1/agents/roles/{role_id}/runHand a job to a role - POST
/api/v1/agents/routines/dismissAgents Routine Dismiss - GET
/api/v1/agents/routines/opportunitiesAgents Routine Opportunities - GET
/api/v1/agents/routines/todayAgents Routine Today - GET
/api/v1/agents/runsList agent runs - POST
/api/v1/agents/runsStart an agent run - GET
/api/v1/agents/runs/{run_id}Get an agent run - POST
/api/v1/agents/runs/{run_id}/answerAnswer a run's question - GET
/api/v1/agents/runs/{run_id}/eventsRead a run's transcript - POST
/api/v1/agents/runs/{run_id}/routineAgents Routine From Run - POST
/api/v1/agents/runs/{run_id}/steerAdjust a running agent run - POST
/api/v1/agents/runs/{run_id}/stopStop an agent run - GET
/api/v1/agents/runs/{run_id}/streamStream a run's transcript (SSE) - POST
/api/v1/agents/runs/{run_id}/trialAgents Routine Trial - POST
/api/v1/agents/runs/{run_id}/verifyAgents Routine Verify - GET
/api/v1/agents/sopsList SOPs - POST
/api/v1/agents/sopsCreate an SOP - POST
/api/v1/agents/sops/formatAuto-structure notes as an SOP - GET
/api/v1/agents/sops/generations/{generation_id}Get a team generation - GET
/api/v1/agents/sops/suggestionsSuggested SOPs - POST
/api/v1/agents/sops/uploadUpload an SOP - DELETE
/api/v1/agents/sops/{sop_id}Archive an SOP - GET
/api/v1/agents/sops/{sop_id}Get an SOP - PATCH
/api/v1/agents/sops/{sop_id}Update an SOP - POST
/api/v1/agents/sops/{sop_id}/duplicateDuplicate an SOP - POST
/api/v1/agents/sops/{sop_id}/generateBuild or update the team for an SOP - POST
/api/v1/agents/sops/{sop_id}/improvementsAgents Routine Improvement - POST
/api/v1/agents/sops/{sop_id}/restoreRestore a previous SOP revision - GET
/api/v1/agents/sops/{sop_id}/revisionsList an SOP's revisions - GET
/api/v1/agents/sops/{sop_id}/revisions/{revision_id}Get an SOP revision - POST
/api/v1/agents/sops/{sop_id}/teams/resumeResume the teams of an SOP - POST
/api/v1/agents/sops/{sop_id}/unarchiveUnarchive an SOP - GET
/api/v1/agents/spendAgent spend by role - GET
/api/v1/agents/staff/browser-sessionsList a business's roles' browser sign-ins (superuser) - DELETE
/api/v1/agents/staff/browser-sessions/{role_id}Sign a role out of every site (superuser) - GET
/api/v1/agents/staff/loginsList saved logins (superuser) - POST
/api/v1/agents/staff/loginsSave a login (superuser) - GET
/api/v1/agents/staff/logins/scopeA business's login scope (superuser) - DELETE
/api/v1/agents/staff/logins/{login_id}Delete a saved login (superuser) - PATCH
/api/v1/agents/staff/logins/{login_id}Update a saved login (superuser) - DELETE
/api/v1/agents/staff/team-vaultDisconnect the team 1Password (superuser) - GET
/api/v1/agents/staff/team-vaultGet the team 1Password (superuser) - PUT
/api/v1/agents/staff/team-vaultConnect the team 1Password (superuser) - POST
/api/v1/agents/staff/team-vault/refreshRefresh the team 1Password index (superuser) - DELETE
/api/v1/agents/staff/team-vault/vaults/{vault_id}/mappingUnmap a team vault (superuser) - PUT
/api/v1/agents/staff/team-vault/vaults/{vault_id}/mappingMap a team vault to a client (superuser) - DELETE
/api/v1/agents/staff/vaultDisconnect a business's or firm's 1Password (superuser) - GET
/api/v1/agents/staff/vaultGet a business's or firm's 1Password (superuser) - PUT
/api/v1/agents/staff/vaultConnect a business's or firm's 1Password (superuser) - POST
/api/v1/agents/staff/vault/refreshRefresh a business's or firm's 1Password index (superuser) - POST
/api/v1/agents/team/pausePause the team - POST
/api/v1/agents/team/resumeResume the team - GET
/api/v1/agents/timelineOne timeline of every agent, connected app and approver - GET
/api/v1/agents/tool-groupsList tool groups and connected servers for a role's tool access - GET
/api/v1/agents/vibesList teammate vibes