Adam API

Inspect an external task subagent

Changed on

Return a subagent's status, result, and produced file references without starting a parent model turn. Supply exactly one of subagentId or toolCallId; the latter can recover a launch whose tool-call outcome is unknown. Requires tasks:read and tools:execute. Returns null when no matching subagent exists. Internal messages, model routes, and raw errors are omitted.

get/v1/tasks/{taskId}/subagents/lookup

Request

Path parameters

taskIdstring uuid required

Query parameters

toolCallIdstring uuid

Launch tool-call identifier. Provide this or subagentId, but not both.

subagentIdstring

Child task UUID. Provide this or toolCallId, but not both.

Response

Changes

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • info

      response property subagent/anyOf[subschema #1]/error list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property subagent/anyOf[subschema #1]/files/items/name list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property subagent/anyOf[subschema #1]/result list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property subagent/anyOf[subschema #1]/toolCallId list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      endpoint added