List objective tool calls

Lists all tool calls for an objective

get/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls

Path parameters

workspaceIdstring required

Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q

objectiveIdstring required

Example:obj_01HXKD2E5NQM3T9AYWCFQAZGFV

The objective ID to return tool calls for

Query parameters

limitinteger

Maximum number of results to return

cursorstring

Pagination cursor from previous response

status'TOOL_CALL_STATUS_UNSPECIFIED' | 'TOOL_CALL_STATUS_AUTO_APPROVED' | 'TOOL_CALL_STATUS_WAITING_FOR_APPROVAL' | 'TOOL_CALL_STATUS_APPROVED' | 'TOOL_CALL_STATUS_DENIED' enum

Filter by tool call status

includeInfoboolean

When set to true you may use more of your alloted API rate-limit

executionStatus'TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED' | 'TOOL_CALL_EXECUTION_STATUS_PENDING' | 'TOOL_CALL_EXECUTION_STATUS_RUNNING' | 'TOOL_CALL_EXECUTION_STATUS_COMPLETED' | 'TOOL_CALL_EXECUTION_STATUS_ERRORED' | 'TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT' enum

Filter by tool call execution status. Useful for reverse-harness polling of bare tool calls waiting for externally supplied content (TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT).

labelsstring

Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).

Response

Example response

{
  "items": [
    {
      "metadata": {
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
      },
      "data": {
        "callable": {
          "tool": {
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
          }
        },
        "statusChangedBy": {
          "metadata": {
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
          }
        }
      },
      "info": {
        "objective": {
          "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
          "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
          "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
        },
        "createdBy": {
          "metadata": {
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
          }
        }
      }
    }
  ]
}

Changes

Changed in 10 of the 57 revisions of this API.21112

Jul 19, 20263ecc1debabfa231See the full diff
- ▲
  added to the /////// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  the /////// response's property type changed from object to no type for status
  response-property-type-changed
- ●
  removed the optional property //////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //////// from the response with the status
  response-optional-property-removed
- ○
  added discriminator to /////// response property for the response status
  response-property-discriminator-added
Jul 8, 2026a99a473ee3ad1See the full diff
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
Jul 8, 2026e72f368ddab71See the full diff
- ○
  added the new optional query request parameter labels
  new-optional-request-parameter
Jul 6, 2026ca78d3d0b7c211See the full diff
- ●
  added the new TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT enum value to the // response property for the response status
  response-property-enum-value-added
- ○
  added the new optional query request parameter executionStatus
  new-optional-request-parameter
Jul 2, 202606e0e37c149932See the full diff
- ●
  removed the optional property ///////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ///////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ///////// from the response with the status
  response-optional-property-removed
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 14, 2026a5462daf43c83See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Jun 10, 2026fca9ba42dc801See the full diff
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
Jun 9, 202613d98d37dd963See the full diff
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 8, 20261c6f66c463031See the full diff
- ○
  the response property // became required for the status
  response-property-became-required
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 5, 20260702cb021b662See the full diff
- ●
  added the new PROFILE_TYPE_UNSPECIFIED enum value to the ///////// response property for the response status
  response-property-enum-value-added
- ●
  added the new PROFILE_TYPE_UNSPECIFIED enum value to the ///// response property for the response status
  response-property-enum-value-added

Full history