--- title: "Continue an objective" method: POST path: "/v1/workspaces/{workspaceId}/objectives/{objectiveId}:continue" tags: ["ObjectiveService", "Objectives"] --- # Continue an objective `POST /v1/workspaces/{workspaceId}/objectives/{objectiveId}:continue` Continues an objective that has completed ## Path parameters - `workspaceId` string, required - `objectiveId` string, required ## Request body - ContinueObjectiveRequest - `workspaceId` string - `objectiveId` string — 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. - `message` string — The message to continue an objective that has completed (or you are enqueing) - `enqueue` boolean — When set to true, the message will be enqueued for when the agent loop is available to process it. - `secrets` ContinueObjectiveRequestSecret[] — 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` string - `value` string ## Response `200` OK - ObjectiveEvent - `metadata` OperationMetadata, required — Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `id` string, required — Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `accountId` string, required — Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `workspaceId` string, required — Workspace this operation belongs to for organizational grouping (prefixed ULID) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} - `createdAt` string, date-time, required — Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `externalId` string — External ID for the operation (e.g., a workflow ID from an external system) - `profileId` string, required — ID of the actor (user or service account) that created this operation - `data` ObjectiveEventData, required - `type` string - `userMessage` UserMessage - `content` string - `toolApprovalRequested` ToolApprovalRequested - `toolCallId` 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` ToolApproved - `toolCallId` string — The ID of the objective tool call record that was approved via the ApproveToolCall RPC. - `toolDenied` ToolDenied - `toolCallId` string — The ID of the objective tool call record that was denied via the DenyToolCall RPC. - `memo` string — The memo provided by the reviewer when denying the tool call. This is passed to the agent to provide further instructions. - `toolCalled` ToolCalled - `toolCallId` string — The ID of the objective tool call record that was executed. - `error` ObjectiveError - `type` string - `message` string - `assistantMessage` AssistantMessage - `content` string - `toolCalls` AssistantToolCall[] - `tool` 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). - `tool` ResourceMetadata — Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `workspaceId` string, required — Workspace this resource belongs to for organizational grouping (prefixed ULID) - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `profileId` string, required — ID of the actor (user or service account) that created this resource - `createdAt` string, date-time, required — Timestamp when this resource was created - `bundleKey` string — Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `updatedAt` string, date-time — Timestamp when this resource was last updated - `agent` ResourceMetadata — Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `workspaceId` string, required — Workspace this resource belongs to for organizational grouping (prefixed ULID) - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `profileId` string, required — ID of the actor (user or service account) that created this resource - `createdAt` string, date-time, required — Timestamp when this resource was created - `bundleKey` string — Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `updatedAt` string, date-time — Timestamp when this resource was last updated - `cadenyaProvidedTool` ResourceMetadata — Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `workspaceId` string, required — Workspace this resource belongs to for organizational grouping (prefixed ULID) - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `profileId` string, required — ID of the actor (user or service account) that created this resource - `createdAt` string, date-time, required — Timestamp when this resource was created - `bundleKey` string — Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `updatedAt` string, date-time — Timestamp when this resource was last updated - `arguments` string - `functionName` string - `toolResult` ToolResult - `toolCallId` string, required - `result` ObjectiveToolCallResult, required — ObjectiveToolCallResult is the content a tool returned after execution. Tools can return multiple content blocks, and blocks can be multi-modal (text, image, audio). Media blocks are stored by Cadenya and served as short-lived signed URLs rather than inline bytes. - `content` ObjectiveToolCallResultContentBlock[], required - `text` ObjectiveToolCallResultTextBlock - `text` string, required - `image` ObjectiveToolCallResultImageBlock - `url` string, required — Short-lived signed URL to download the stored image. - `mimeType` string, required — IANA media type of the stored image, e.g. image/png. - `sizeBytes` string, required — Size of the stored image in bytes. - `expiresAt` string, date-time, required — When the signed URL expires. - `audio` ObjectiveToolCallResultAudioBlock - `url` string, required — Short-lived signed URL to download the stored audio. - `mimeType` string, required — IANA media type of the stored audio, e.g. audio/wav. - `sizeBytes` string, required — Size of the stored audio in bytes. - `expiresAt` string, date-time, required — When the signed URL expires. - `toolError` ToolError - `toolCallId` string — The ID of the objective tool call record that encountered an error during execution. - `message` string - `contextWindowCompacted` ContextWindowCompacted - `newContextWindow` ObjectiveContextWindowData - `objectiveId` string — The objective's ID that this window belongs to - `sequence` integer — 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. - `promptTokens` integer — A calculated value for how many prompt tokens (input tokens) have been used in this context window - `completionTokens` integer — A calculated value for how many completion tokens (output tokens) have been used in this context window - `previousWindowContinueInstructions` string — The instructions for this window to continue from a previous window's chat history. - `strategies` string[] — The strategies that were applied during this compaction - `messagesCompacted` integer — Number of messages that were compacted - `summary` string — The summary generated by the summarization strategy, if used. - `memoryRead` MemoryRead — MemoryRead is emitted each time the agent resolves a key against the memory cascade and loads an entry. Lookups that miss (key not found in any layer) do not emit this event. - `message` string — Human-readable description of the read, set by the runtime. For example: "Loaded skill", "Resolved context key". Not machine-parsed; intended for UI display alongside the other events in an objective's timeline. - `memoryLayerId` string — The layer the entry resolved to. The top-most layer that contained the key — other layers beneath it that also contained the key are shadowed and not referenced here. - `memoryEntryId` string — The specific entry that was read. - `cancelled` ObjectiveCancelled — ObjectiveCancelled is the terminal event written when an objective is cancelled. After this event, the objective is super-terminal: no further iterations, compaction, or continuation are permitted. - `message` string — Optional human-readable note recorded at cancel time. Today the workflow sets "Cancelled" but this field leaves room for richer reasons (e.g. "Cancelled by user", "Cancelled by schedule sweep", "Credit balance exhausted"). - `subAgentSpawned` SubAgentSpawned - `agent` ResourceMetadata — Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `workspaceId` string, required — Workspace this resource belongs to for organizational grouping (prefixed ULID) - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `profileId` string, required — ID of the actor (user or service account) that created this resource - `createdAt` string, date-time, required — Timestamp when this resource was created - `bundleKey` string — Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `updatedAt` string, date-time — Timestamp when this resource was last updated - `objective` OperationMetadata — Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `id` string, required — Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `accountId` string, required — Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `workspaceId` string, required — Workspace this operation belongs to for organizational grouping (prefixed ULID) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} - `createdAt` string, date-time, required — Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `externalId` string — External ID for the operation (e.g., a workflow ID from an external system) - `profileId` string, required — ID of the actor (user or service account) that created this operation - `task` string - `subAgentUpdated` SubAgentUpdated - `agent` BareMetadata — BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `id` string - `name` string — Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `objective` BareMetadata — BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `id` string - `name` string — Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `status` 'STATUS_UNSPECIFIED' | 'STATUS_PENDING' | 'STATUS_RUNNING' | 'STATUS_COMPLETED' | 'STATUS_FAILED' | 'STATUS_CANCELLED', enum - `message` string - `finalized` ObjectiveFinalized — ObjectiveFinalized is the terminal event written when an objective is finalized. After this event, the objective is super-terminal: no further iterations, compaction, or continuation are permitted. - `output` object — If the objective was created with an output schema, and the agent successfully completed the objective, this field will contain the structured output of the objective. - `contextWindowId` string - `info` ObjectiveEventInfo - `objective` OperationMetadata — Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `id` string, required — Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `accountId` string, required — Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `workspaceId` string, required — Workspace this operation belongs to for organizational grouping (prefixed ULID) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} - `createdAt` string, date-time, required — Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `externalId` string — External ID for the operation (e.g., a workflow ID from an external system) - `profileId` string, required — ID of the actor (user or service account) that created this operation - `createdBy` Profile — A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `metadata` AccountResourceMetadata, required — AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system) - `labels` object — Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `profileId` string, required - `spec` ProfileSpec, required — Configuration for a profile. - `email` string — Email address of the profile. Required and unique within an account for user profiles. - `name` string — Display name (e.g., "Bobby Tables"). - `type` 'PROFILE_TYPE_UNSPECIFIED' | 'PROFILE_TYPE_USER' | 'PROFILE_TYPE_API_KEY' | 'PROFILE_TYPE_SYSTEM', enum, required — Whether this profile represents a human user, an API key, or a system principal. ## Other responses - `default` — Default error response ## Changes - **2026-06-10** `fca9ba42dc80` — 1 warning, 2 info - removed the optional property `data/toolResult/content` from the response with the `200` status - the response property `data/toolResult/toolCallId` became required for the status `200` - added the required property `data/toolResult/result` to the response with the `200` status - **2026-06-09** `13d98d37dd96` — 4 info - added the optional property `data/assistantMessage/toolCalls/items/tool/agent/updatedAt` to the response with the `200` status - added the optional property `data/assistantMessage/toolCalls/items/tool/cadenyaProvidedTool/updatedAt` to the response with the `200` status - added the optional property `data/assistantMessage/toolCalls/items/tool/tool/updatedAt` to the response with the `200` status - added the optional property `data/subAgentSpawned/agent/updatedAt` to the response with the `200` status - **2026-06-08** `1c6f66c46303` — 1 info - endpoint added [Change history](https://skmtc.dev/cadenya/apis/cadenya-api/changes/v1/workspaces/:workspaceId/objectives/:objectiveId:continue/post.md) --- [API](https://skmtc.dev/cadenya/apis/cadenya-api.md) · [All operations](https://skmtc.dev/cadenya/apis/cadenya-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cadenya/cadenya-api/revisions/ea07a25ab5da/schema)