ObjectiveService
Objectives

Continue an objective

Changed on

Continues an objective that has completed

post/v1/workspaces/{workspaceId}/objectives/{objectiveId}:continue

Request

  • Base URL
    https://api.cadenya.com
  • URL
    https://api.cadenya.com/v1/workspaces/{workspaceId}/objectives/{objectiveId}:continue
  • Auth
    HTTP bearer

Path parameters

workspaceIdstring required
Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q
objectiveIdstring required
Example:obj_01HXKD2E5NQM3T9AYWCFQAZGFV

The ID of the objective. If you have assigned an external ID to the objective, you can prefix the ID with "external_id:". For example, "external_id:1234567890". Otherwise, the ID assigned by Cadenya should be used.

Request body

workspaceIdstring
objectiveIdstring

The ID of the objective. If you have assigned an external ID to the objective, you can prefix the ID with "external_id:". For example, "external_id:1234567890". Otherwise, the ID assigned by Cadenya should be used.

messagestring required

The message to continue an objective that has completed (or you are enqueing)

enqueueboolean

When set to true, the message will be enqueued for when the agent loop is available to process it.

Example request

{
  "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
  "objectiveId": "obj_01HXKD2E5NQM3T9AYWCFQAZGFV"
}

Response

OK

contextWindowIdstring
durationstring

Elapsed time of the work this event records, when it is known at write time (e.g. assistant message generation, tool execution for result/error events). Unset means the event is instantaneous or the duration is not measurable. Serialized as a canonical duration string (e.g. "4.1s"). Always set together with started_at.

startedAtstring date-time

When the work this event records began. Set together with duration, so the work interval is [started_at, started_at + duration]. The event's created_at remains the time the event was persisted.

Example response

{
  "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

  • ac1a7f084068Revision changes
    • breaking

      added to the response property oneOf list for the response status

    • info

      added reasoning discriminator mapping keys to the response property for the response status

  • cf00ce9538ecRevision changes
    • info

      added the optional property to the response with the status