Adam API

Run a tool in an external task

Changed on Oct 29, 2026

Queue a tool call for an external task you own. Use a tool name and input schema from listTaskTools. This runs the selected tool without an Adam agent or model loop; tools may provision compute, use connected accounts or credentials, and incur usage charges. Poll getToolCall for the outcome. An unknown outcome must not be retried with a new key because the operation may have taken effect.

post/v1/tasks/{taskId}/tool-calls

Request

Base URL
https://api.adam.new
Auth
- HTTP bearer
- or OAuth 2
  Authorization codehttps://api.adam.new/auth/oauth2/authorize
  Token URLhttps://api.adam.new/auth/oauth2/token
  Scopestasks:write, tools:execute
TypeScript
https://skmtc.dev/adam/apis/adam-api/docs/v1/tasks/:taskId/tool-calls/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

taskIdstring uuid required

Headers

Idempotency-Keystring required

Required unique key for this tool call. Reuse it with the same task, tool and input to retrieve the original call rather than execute it again.

Request body

toolstring required

inputobject required

Response

Changes

Oct 29, 20264baea94e5dbc Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- info
  response property call/finishedAt list-of-types was narrowed by removing types null from media type application/json of response 202
- info
  response property call/startedAt list-of-types was narrowed by removing types null from media type application/json of response 202
Oct 9, 2026135cef4f7586 Revision changes
- info
  endpoint added

Operation history