--- 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, required — 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. ## 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 — Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric characters with "-", "_", or "." allowed between; keys follow the same shape and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/") of at most 253 characters. 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` union, required - ObjectiveEventDataUserMessage - `type` 'userMessage', required - `userMessage` UserMessage, required - `content` string - ObjectiveEventDataToolApprovalRequested - `type` 'toolApprovalRequested', required - `toolApprovalRequested` ToolApprovalRequested, required - `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. - ObjectiveEventDataToolApproved - `type` 'toolApproved', required - `toolApproved` ToolApproved, required - `toolCallId` string — The ID of the objective tool call record that was approved via the ApproveToolCall RPC. - ObjectiveEventDataToolDenied - `type` 'toolDenied', required - `toolDenied` ToolDenied, required - `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. - ObjectiveEventDataToolCalled - `type` 'toolCalled', required - `toolCalled` ToolCalled, required - `toolCallId` string — The ID of the objective tool call record that was executed. - `tool` union — 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). - CallableToolTool - `type` 'tool', required - `tool` ResourceMetadata, required — Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - … - CallableToolAgent - `type` 'agent', required - `agent` ResourceMetadata, required — Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - … - CallableToolCadenyaProvidedTool - `type` 'cadenyaProvidedTool', required - `cadenyaProvidedTool` ResourceMetadata, required — Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - … - `config` union — Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - ToolSpecConfigHttp - `type` 'http', required - `http` ConfigHTTP, required - … - ToolSpecConfigMcp - `type` 'mcp', required - `mcp` ConfigMCP, required - … - ToolSpecConfigOpenapi - `type` 'openapi', required - `openapi` ConfigOpenAPI, required - … - ToolSpecConfigBare - `type` 'bare', required - `bare` ConfigBare, required — Marks the tool as bare: it has no execution adapter of its own and relies on the parent tool set being a Bare tool set. Present so a webhook consumer can tell a tool is bare from the tool data alone, without cross-referencing the tool set. - `arguments` object — The arguments passed to the tool. - ObjectiveEventDataError - `type` 'error', required - `error` ObjectiveError, required - `type` string - `message` string - ObjectiveEventDataAssistantMessage - `type` 'assistantMessage', required - `assistantMessage` AssistantMessage, required - `content` string - `toolCalls` AssistantToolCall[] - `tool` union — 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). - CallableToolTool - … - CallableToolAgent - … - CallableToolCadenyaProvidedTool - … - `arguments` string - `functionName` string - ObjectiveEventDataToolResult - `type` 'toolResult', required - `toolResult` ToolResult, required - `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 - union — ContentBlock is a single block of tool result content. Exactly one of the variants is set. - … - ObjectiveEventDataToolError - `type` 'toolError', required - `toolError` ToolError, required - `toolCallId` string — The ID of the objective tool call record that encountered an error during execution. - `message` string - ObjectiveEventDataContextWindowCompacted - `type` 'contextWindowCompacted', required - `contextWindowCompacted` ContextWindowCompacted, required - `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. - ObjectiveEventDataMemoryRead - `type` 'memoryRead', required - `memoryRead` MemoryRead, required — 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. - ObjectiveEventDataCancelled - `type` 'cancelled', required - `cancelled` ObjectiveCancelled, required — 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"). - ObjectiveEventDataSubAgentSpawned - `type` 'subAgentSpawned', required - `subAgentSpawned` SubAgentSpawned, required - `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 — Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric characters with "-", "_", or "." allowed between; keys follow the same shape and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/") of at most 253 characters. 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 - `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 — Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric characters with "-", "_", or "." allowed between; keys follow the same shape and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/") of at most 253 characters. 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 - ObjectiveEventDataSubAgentUpdated - `type` 'subAgentUpdated', required - `subAgentUpdated` SubAgentUpdated, required - `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 - ObjectiveEventDataFinalized - `type` 'finalized', required - `finalized` ObjectiveFinalized, required — 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. - ObjectiveEventDataNotice - `type` 'notice', required - `notice` Notice, required — Notice is a non-terminal diagnostic emitted by the runtime when something noteworthy but non-fatal happens during an objective — for example a just-in-time tool set failing to load, or a previously loaded tool being dropped because it was archived. Notices carry no structured payload; they exist to make the objective timeline self-explanatory. - `level` 'LEVEL_UNSPECIFIED' | 'LEVEL_INFO' | 'LEVEL_WARN' | 'LEVEL_INFO' | 'LEVEL_WARN', enum - `message` string — Human-readable description of what happened. - `key` string — Stable machine-readable identifier for the notice kind (for example "tool_set_load_failed", "tool_archived"). Clients can switch on it or use it as an i18n key; the message is the English fallback. - ObjectiveEventDataTimedOut - `type` 'timedOut', required - `timedOut` ObjectiveTimedOut, required — ObjectiveTimedOut is the terminal event written when an objective is finalized by the inactivity sweep because it saw no activity (no user messages, no LLM calls) within its variation's inactivity timeout — or the system-wide 24 hour maximum when no timeout is configured. The objective produces no output. After this event, the objective is super-terminal: no further iterations, compaction, or continuation are permitted. - `message` string — Human-readable note recorded at timeout time (e.g. "Timed out after 2h of inactivity"). - ObjectiveEventDataReasoning - `type` 'reasoning', required - `reasoning` Reasoning, required — Reasoning carries the human-readable reasoning text a model produced while working on an iteration — extended thinking (Anthropic, Gemini) or reasoning summaries (OpenAI). It is emitted alongside the assistant message from the same model response and is purely informational: the text shown here is never sent back to the model. - `content` string, required — The reasoning text. May be a verbatim chain of thought or a provider-generated summary depending on the model. - `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 — Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric characters with "-", "_", or "." allowed between; keys follow the same shape and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/") of at most 253 characters. 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 — Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric characters with "-", "_", or "." allowed between; keys follow the same shape and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/") of at most 253 characters. Examples: {"environment": "production", "team": "platform", "version": "v2"} - `profileId` string, required - `createdAt` string, date-time - `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. - `duration` string — 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. - `startedAt` string, 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. ## Other responses - `default` — Default error response --- [API](https://skmtc.net/cadenya/apis/cadenya-api.md) · [All operations](https://skmtc.net/cadenya/apis/cadenya-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cadenya/cadenya-api/versions/ac1a7f084068/schema)