## Continue an objective

**post** `/v1/objectives/{objectiveId}/continue`

Continues an objective that has completed

### Path Parameters

- `objectiveId: string`

### Body Parameters

- `enqueue: optional boolean`

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

- `message: optional string`

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

- `secrets: optional array of object { name, value }`

  Secrets that should be included with the message. Helpful for when you need to update secrets on the objective (IE: A secret expires and needs to be refreshed)

  - `name: optional string`

  - `value: optional string`

### Returns

- `data: ObjectiveEventData`

  - `assistantMessage: optional AssistantMessage`

    - `content: optional string`

    - `toolCalls: optional array of AssistantToolCall`

      - `arguments: optional string`

      - `functionName: optional string`

      - `tool: optional CallableTool`

        CallableTool is a union that represents a tool that can be called by an agent. In Cadenya, a tool that is used within an agent objective
        might be a user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context), or a Cadenya Tool (one Cadenya provides).

        - `agent: optional ResourceMetadata`

          Standard metadata for persistent, named resources (e.g., agents, tools, prompts)

          - `id: string`

            Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...")

          - `accountId: string`

            Account this resource belongs to for multi-tenant isolation (prefixed ULID)

          - `createdAt: string`

            Timestamp when this resource was created

          - `name: string`

            Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool")
            Required for resources that users interact with directly

          - `profileId: string`

            ID of the actor (user or service account) that created this resource

          - `workspaceId: string`

            Workspace this resource belongs to for organizational grouping (prefixed ULID)

          - `externalId: optional string`

            External ID for the resource (e.g., a workflow ID from an external system)

          - `labels: optional map[string]`

            Arbitrary key-value pairs for categorization and filtering
            Examples: {"environment": "production", "team": "platform", "version": "v2"}

        - `cadenyaProvidedTool: optional ResourceMetadata`

          Standard metadata for persistent, named resources (e.g., agents, tools, prompts)

        - `tool: optional ResourceMetadata`

          Standard metadata for persistent, named resources (e.g., agents, tools, prompts)

  - `contextWindowCompacted: optional ContextWindowCompacted`

    - `messagesCompacted: optional number`

      Number of messages that were compacted

    - `newContextWindow: optional ObjectiveContextWindowData`

      The new context window created by this compaction

      - `completionTokens: optional number`

        A calculated value for how many completion tokens (output tokens) have been used in this context window

      - `objectiveId: optional string`

        The objective's ID that this window belongs to

      - `previousWindowContinueInstructions: optional string`

        The instructions for this window to continue from a previous window's chat history.

      - `promptTokens: optional number`

        A calculated value for how many prompt tokens (input tokens) have been used in this context window

      - `sequence: optional number`

        sequence is a numeric representation of which context window this is. Sequences are useful to perform a max(sequence) on in order
        to calculate how many context windows an objective has.

    - `strategies: optional array of string`

      The strategies that were applied during this compaction

    - `summary: optional string`

      The summary generated by the summarization strategy, if used.

  - `error: optional ObjectiveError`

    - `message: optional string`

    - `type: optional string`

  - `subObjectiveCreated: optional SubObjectiveCreated`

    - `metadata: optional OperationMetadata`

      Metadata for ephemeral operations and activities (e.g., objectives, executions, runs)

      - `id: string`

        Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...")

      - `accountId: string`

        Account this operation belongs to for multi-tenant isolation (prefixed ULID)

      - `createdAt: string`

        Timestamp when this operation was created
        ULID includes timestamp information, but this explicit field enables easier querying

      - `profileId: string`

        ID of the actor (user or service account) that created this operation

      - `workspaceId: string`

        Workspace this operation belongs to for organizational grouping (prefixed ULID)

      - `externalId: optional string`

        External ID for the operation (e.g., a workflow ID from an external system)

      - `labels: optional map[string]`

        Arbitrary key-value pairs for categorization and filtering
        Examples: {"priority": "high", "source": "api", "workflow": "onboarding"}

  - `toolApprovalRequested: optional ToolApprovalRequested`

    - `toolCallId: optional string`

      The ID of the objective tool call record. Use this ID with the ApproveToolCall or DenyToolCall RPCs to approve or deny the tool call.

  - `toolApproved: optional ToolApproved`

    - `toolCallId: optional string`

      The ID of the objective tool call record that was approved via the ApproveToolCall RPC.

  - `toolCalled: optional ToolCalled`

    - `toolCallId: optional string`

      The ID of the objective tool call record that was executed.

  - `toolDenied: optional ToolDenied`

    - `memo: optional string`

      The memo provided by the reviewer when denying the tool call. This is passed to the agent to provide further instructions.

    - `toolCallId: optional string`

      The ID of the objective tool call record that was denied via the DenyToolCall RPC.

  - `toolError: optional ToolError`

    - `message: optional string`

    - `toolCallId: optional string`

      The ID of the objective tool call record that encountered an error during execution.

  - `toolResult: optional ToolResult`

    - `content: optional string`

    - `toolCallId: optional string`

  - `type: optional string`

  - `userMessage: optional UserMessage`

    - `content: optional string`

- `metadata: OperationMetadata`

  Metadata for ephemeral operations and activities (e.g., objectives, executions, runs)

- `contextWindowId: optional string`

- `info: optional ObjectiveEventInfo`

  - `createdBy: optional Profile`

    Profile represents a human user at the account level.
    Profiles are account-scoped resources that can be associated with multiple workspaces
    through the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).

    - `metadata: AccountResourceMetadata`

      AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace.

      - `id: string`

        Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")

      - `accountId: string`

        Account this resource belongs to for multi-tenant isolation (prefixed ULID)

      - `name: string`

        Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool")
        Required for resources that users interact with directly

      - `profileId: string`

      - `externalId: optional string`

        External ID for the resource (e.g., a workflow ID from an external system)

      - `labels: optional map[string]`

        Arbitrary key-value pairs for categorization and filtering
        Examples: {"environment": "production", "team": "platform", "version": "v2"}

    - `spec: ProfileSpec`

      ProfileSpec contains the profile-specific fields

      - `type: "PROFILE_TYPE_USER" or "PROFILE_TYPE_API_KEY" or "PROFILE_TYPE_SYSTEM"`

        Type is the type of profile. User's are humans, API keys are computers. You know the deal.

        - `"PROFILE_TYPE_USER"`

        - `"PROFILE_TYPE_API_KEY"`

        - `"PROFILE_TYPE_SYSTEM"`

      - `email: optional string`

        Email address of the user (required, unique per account)

      - `name: optional string`

        Display name for the user (e.g., "Bobby Tables")

  - `objective: optional OperationMetadata`

    Metadata for ephemeral operations and activities (e.g., objectives, executions, runs)

### Example

```http
curl https://api.cadenya.com/v1/objectives/$OBJECTIVE_ID/continue \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CADENYA_API_KEY" \
    -d '{}'
```

#### Response

```json
{
  "data": {
    "assistantMessage": {
      "content": "content",
      "toolCalls": [
        {
          "arguments": "arguments",
          "functionName": "functionName",
          "tool": {
            "agent": {
              "id": "id",
              "accountId": "accountId",
              "createdAt": "2019-12-27T18:11:19.117Z",
              "name": "name",
              "profileId": "profileId",
              "workspaceId": "workspaceId",
              "externalId": "externalId",
              "labels": {
                "foo": "string"
              }
            },
            "cadenyaProvidedTool": {
              "id": "id",
              "accountId": "accountId",
              "createdAt": "2019-12-27T18:11:19.117Z",
              "name": "name",
              "profileId": "profileId",
              "workspaceId": "workspaceId",
              "externalId": "externalId",
              "labels": {
                "foo": "string"
              }
            },
            "tool": {
              "id": "id",
              "accountId": "accountId",
              "createdAt": "2019-12-27T18:11:19.117Z",
              "name": "name",
              "profileId": "profileId",
              "workspaceId": "workspaceId",
              "externalId": "externalId",
              "labels": {
                "foo": "string"
              }
            }
          }
        }
      ]
    },
    "contextWindowCompacted": {
      "messagesCompacted": 0,
      "newContextWindow": {
        "completionTokens": 0,
        "objectiveId": "objectiveId",
        "previousWindowContinueInstructions": "previousWindowContinueInstructions",
        "promptTokens": 0,
        "sequence": 0
      },
      "strategies": [
        "string"
      ],
      "summary": "summary"
    },
    "error": {
      "message": "message",
      "type": "type"
    },
    "subObjectiveCreated": {
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "createdAt": "2019-12-27T18:11:19.117Z",
        "profileId": "profileId",
        "workspaceId": "workspaceId",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      }
    },
    "toolApprovalRequested": {
      "toolCallId": "toolCallId"
    },
    "toolApproved": {
      "toolCallId": "toolCallId"
    },
    "toolCalled": {
      "toolCallId": "toolCallId"
    },
    "toolDenied": {
      "memo": "memo",
      "toolCallId": "toolCallId"
    },
    "toolError": {
      "message": "message",
      "toolCallId": "toolCallId"
    },
    "toolResult": {
      "content": "content",
      "toolCallId": "toolCallId"
    },
    "type": "type",
    "userMessage": {
      "content": "content"
    }
  },
  "metadata": {
    "id": "id",
    "accountId": "accountId",
    "createdAt": "2019-12-27T18:11:19.117Z",
    "profileId": "profileId",
    "workspaceId": "workspaceId",
    "externalId": "externalId",
    "labels": {
      "foo": "string"
    }
  },
  "contextWindowId": "contextWindowId",
  "info": {
    "createdBy": {
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "name": "name",
        "profileId": "profileId",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      },
      "spec": {
        "type": "PROFILE_TYPE_USER",
        "email": "email",
        "name": "name"
      }
    },
    "objective": {
      "id": "id",
      "accountId": "accountId",
      "createdAt": "2019-12-27T18:11:19.117Z",
      "profileId": "profileId",
      "workspaceId": "workspaceId",
      "externalId": "externalId",
      "labels": {
        "foo": "string"
      }
    }
  }
}
```