ObjectiveService
Objectives

List objective events

Lists all events for an objective

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

Path parameters

workspaceIdstring required
Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q
objectiveIdstring required
Example:obj_01HXKD2E5NQM3T9AYWCFQAZGFV

Objective ID for filtering

Query parameters

limitinteger

Maximum number of results to return

cursorstring

Pagination cursor from previous response

sortOrderstring

Sort order for results (asc or desc by creation time)

includeInfoboolean

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

windowIdstring

Optional context window ID to filter events by

sinceEventIdstring

Optional string to fetch events since an ID

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

OK

Example response

{
  "items": [
    {
      "metadata": {
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
      },
      "data": {
        "toolApprovalRequested": {
          "toolCallId": "toolcall_01HXKD2E5NQM3T9AYWCFTANFGV"
        }
      },
      "contextWindowId": "objwin_01HXKD2E5NQM3T9AYWCFN7BSTR",
      "info": {
        "objective": {
          "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
          "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
          "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
        },
        "createdBy": {
          "metadata": {
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
          }
        }
      }
    }
  ]
}

Changes

Changed in 13 of the 57 revisions of this API.32517

    • added ObjectiveEventData_Reasoning to the items/items/data response property oneOf list for the response status 200

      response-property-one-of-added

    • added reasoning discriminator mapping keys to the items/items/data response property for the response status 200

      response-property-discriminator-mapping-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the optional property items/items/startedAt to the response with the 200 status

      response-optional-property-added

    • added the optional property items/items/duration to the response with the 200 status

      response-optional-property-added

  • 3ecc1debabfa2181See the full diff
    • added ObjectiveEventData_UserMessage ObjectiveEventData_ToolApprovalRequested ObjectiveEventData_ToolApproved ObjectiveEventData_ToolDenied ObjectiveEventData_ToolCalled ObjectiveEventData_Error ObjectiveEventData_AssistantMessage ObjectiveEventData_ToolResult ObjectiveEventData_ToolError ObjectiveEventData_ContextWindowCompacted ObjectiveEventData_MemoryRead ObjectiveEventData_Cancelled ObjectiveEventData_SubAgentSpawned ObjectiveEventData_SubAgentUpdated ObjectiveEventData_Finalized ObjectiveEventData_Notice ObjectiveEventData_TimedOut to the items/items/data response property oneOf list for the response status 200

      response-property-one-of-added

    • the items/items/data response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • removed the optional property items/items/data/assistantMessage from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/cancelled from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/contextWindowCompacted from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/error from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/finalized from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/memoryRead from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/notice from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/subAgentSpawned from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/subAgentUpdated from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/timedOut from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/toolApprovalRequested from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/toolApproved from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/toolCalled from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/toolDenied from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/toolError from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/toolResult from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/type from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/userMessage from the response with the 200 status

      response-optional-property-removed

    • added discriminator to items/items/data response property for the response status 200

      response-property-discriminator-added

    • removed the optional property pagination/total from the response with the 200 status

      response-optional-property-removed

    • added the new optional query request parameter labels

      new-optional-request-parameter

    • added the optional property items/items/data/timedOut to the response with the 200 status

      response-optional-property-added

    • added the optional property items/items/data/toolCalled/arguments to the response with the 200 status

      response-optional-property-added

    • added the optional property items/items/data/toolCalled/config to the response with the 200 status

      response-optional-property-added

    • added the optional property items/items/data/toolCalled/tool to the response with the 200 status

      response-optional-property-added

    • added the optional property items/items/data/notice to the response with the 200 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

    • removed the optional property items/items/data/assistantMessage/toolCalls/items/tool/agent/bundleKey from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/assistantMessage/toolCalls/items/tool/cadenyaProvidedTool/bundleKey from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/assistantMessage/toolCalls/items/tool/tool/bundleKey from the response with the 200 status

      response-optional-property-removed

    • removed the optional property items/items/data/subAgentSpawned/agent/bundleKey from the response with the 200 status

      response-optional-property-removed

    • added the optional property items/items/info/createdBy/metadata/createdAt to the response with the 200 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