List objectives

GET/v1/workspaces/{workspaceId}/objectives

Lists all objectives in the workspace

Path ParametersExpand Collapse

workspaceId: string

Query ParametersExpand Collapse

agentId: optional string

Agent ID for filtering

agentScheduleId: optional string

Filter to objectives produced by a specific AgentSchedule. Accepts canonical as_… form or external_id: form.

cursor: optional string

Pagination cursor from previous response

includeInfo: optional boolean

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

limit: optional number

Maximum number of results to return

formatint32

parentObjectiveId: optional string

Optional filters

profileId: optional string

sortOrder: optional string

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

state: optional "STATE_UNSPECIFIED" or "STATE_PENDING" or "STATE_RUNNING" or 4 more

Filter by state

formatenum

One of the following:

"STATE_UNSPECIFIED"

"STATE_PENDING"

"STATE_RUNNING"

"STATE_WAITING"

"STATE_FAILED"

"STATE_CANCELLED"

"STATE_FINALIZED"

ReturnsExpand Collapse

items: optional array of Objective { data, metadata, status, 2 more }

data: ObjectiveData { agent, data, initialMessage, 8 more }

agent: optional Agent { metadata, spec, info }

Agent resource

metadata: ResourceMetadata { id, accountId, createdAt, 6 more }

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

formatdate-time

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)

bundleKey: optional 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.

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: AgentSpec { status, variationSelectionMode, description, 3 more }

Agent specification (user-provided configuration)

status: "AGENT_STATUS_UNSPECIFIED" or "AGENT_STATUS_DRAFT" or "AGENT_STATUS_PUBLISHED" or "AGENT_STATUS_ARCHIVED"

Status of the agent

formatenum

One of the following:

"AGENT_STATUS_UNSPECIFIED"

"AGENT_STATUS_DRAFT"

"AGENT_STATUS_PUBLISHED"

"AGENT_STATUS_ARCHIVED"

variationSelectionMode: "VARIATION_SELECTION_MODE_UNSPECIFIED" or "VARIATION_SELECTION_MODE_RANDOM" or "VARIATION_SELECTION_MODE_WEIGHTED"

Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified

formatenum

One of the following:

"VARIATION_SELECTION_MODE_UNSPECIFIED"

"VARIATION_SELECTION_MODE_RANDOM"

"VARIATION_SELECTION_MODE_WEIGHTED"

description: optional string

Description of the agent’s purpose

inputDataSchema: optional map[unknown]

InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool’s input parameter schema. If omitted, the sub-agent schema will be loaded with a simple “prompt” free text string as its schema.

outputDefinition: optional map[unknown]

Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives.

webhookEventsUrl: optional string

The URL that Cadenya will send events for any objective assigned to the agent.

info: optional AgentInfo { createdBy, variationCount }

AgentInfo contains simple information about an agent for display or quick reference

createdBy: optional Profile { metadata, spec }

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 { id, accountId, name, 3 more }

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)

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 { type, email, name }

Configuration for a profile.

type: "PROFILE_TYPE_UNSPECIFIED" or "PROFILE_TYPE_USER" or "PROFILE_TYPE_API_KEY" or "PROFILE_TYPE_SYSTEM"

Whether this profile represents a human user, an API key, or a system principal.

formatenum

One of the following:

"PROFILE_TYPE_UNSPECIFIED"

"PROFILE_TYPE_USER"

"PROFILE_TYPE_API_KEY"

"PROFILE_TYPE_SYSTEM"

email: optional string

Email address of the profile. Required and unique within an account for user profiles.

Display name (e.g., “Bobby Tables”).

variationCount: optional number

data: optional unknown

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

initialMessage: optional string

The initial message sent to the agent. This becomes the first user message in the LLM chat history.

memoryStack: optional array of MemoryReference { memoryEntryId, memoryLayerId }

Memory layers/entries to push onto this objective’s memory stack on top of the baseline stack inherited from the selected variation.

Array order is push order: the first element sits lower in the objective’s contribution to the stack; the LAST element ends up on top of the effective stack. Entries pinned via memory_entry_id behave as single-entry layers at their position.

System-managed layers (e.g., episodic) cannot be referenced here; they attach themselves automatically based on episodic_key.

Stack size cap: the TOTAL effective stack (variation’s memory layers

this field) must not exceed 10 entries. A request that would produce an effective stack larger than 10 is rejected with InvalidArgument.

memoryEntryId: optional string

When set, pushes only this entry from memory_layer_id onto the stack — behaves as a single-entry layer (only this key resolves at this position). The entry must belong to memory_layer_id; mismatches are rejected with InvalidArgument.

memoryLayerId: optional string

output: optional map[unknown]

The output of the objective, populated when the objective completes. Will match the schema of output_json_schema or output_json_inferred.

outputDefinition: optional map[unknown]

Snapshot of the agent spec’s output_definition at objective creation time. When present, the objective will run an extraction step after the LLM finishes.

parentObjectiveId: optional string

A parent objective means the objective was spawned off using a separate agent to complete an objective

secrets: optional array of ObjectiveDataSecret { name, value }

Secrets that can be used in the headers for tool calls using the secret interpolation format.

value: optional string

sourceScheduleId: optional string

ID of the AgentSchedule that produced this objective, when applicable. Populated when the objective is created from a schedule fire; empty when the objective was created via CreateObjective directly.

systemPrompt: optional string

system_prompt is read-only, derived from the selected variation’s prompt

variation: optional AgentVariation { metadata, spec, info }

AgentVariation resource

metadata: ResourceMetadata { id, accountId, createdAt, 6 more }

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

formatdate-time

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)

bundleKey: optional 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: AgentVariationSpec { compactionConfig, constraints, description, 6 more }

AgentVariationSpec defines the operational configuration for a variation

compactionConfig: optional AgentVariationSpecCompactionConfig { summarization, toolResultClearing, triggerThreshold }

CompactionConfig defines how context window compaction behaves for objectives using this variation.

summarization: optional CompactionConfigSummarizationStrategy { instructions }

SummarizationStrategy configures LLM-powered summarization of older conversation turns.

instructions: optional string

Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: “Preserve all code snippets, variable names, and technical decisions.”

toolResultClearing: optional CompactionConfigToolResultClearingStrategy { preserveRecentResults }

ToolResultClearingStrategy configures clearing of older tool result content.

preserveRecentResults: optional number

Number of most recent tool call results to keep intact. Older tool results have their content replaced with “[result cleared]” while preserving the assistant tool call message (function name, arguments). Default: 2

formatint32

triggerThreshold: optional number

Trigger threshold as a percentage of the model’s context window (0.0 to 1.0). When input tokens reach this percentage of the model’s limit, compaction triggers. Default: 0.75 (75%)

formatfloat

constraints: optional AgentVariationSpecConstraints { maxSubObjectives, maxToolCalls }

Execution constraints

maxSubObjectives: optional number

The maximum number of sub-objectives that can be created. 0 means no limit.

formatint32

maxToolCalls: optional number

The maximum number of tool calls that can be made. 0 means no limit.

formatint32

description: optional string

Human-readable description of what this variation does or when it should be used

enableEpisodicMemory: optional boolean

Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective’s episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode.

episodicMemoryTtl: optional number

How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely.

modelConfig: optional AgentVariationSpecModelConfig { modelId, temperature }

ModelConfig defines the model configuration for a variation

modelId: optional string

The model identifier in family/model format (e.g., “claude/opus-4.6”, “claude/sonnet-4.5”)

temperature: optional number

Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness

formatfloat

progressiveDiscovery: optional AgentVariationSpecProgressiveDiscovery { hints, maxTools, rerankThreshold }

ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task.

hints: optional array of string

maxTools: optional number

rerankThreshold: optional number

Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed.

formatfloat

prompt: optional string

The system prompt for this variation

weight: optional number

Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent’s variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest.

formatint32

info: optional AgentVariationInfo { assignments, createdBy, feedbackCount, 7 more }

AgentVariationInfo provides read-only summary information about a variation

assignments: optional array of VariationAssignment { id, agent, tool, toolSet }

All tools, tool sets, and sub-agents assigned to this variation. Populated on reads so clients can render a variation’s full assignment list without calling the add/remove endpoints just to enumerate.

id: optional string

agent: optional BareMetadata { id, name }

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: optional 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).

tool: optional BareMetadata { id, name }

id: optional 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).

toolSet: optional BareMetadata { id, name }

id: optional 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).

createdBy: optional Profile { metadata, spec }

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 { id, accountId, name, 3 more }

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)

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 { type, email, name }

Configuration for a profile.

type: "PROFILE_TYPE_UNSPECIFIED" or "PROFILE_TYPE_USER" or "PROFILE_TYPE_API_KEY" or "PROFILE_TYPE_SYSTEM"

Whether this profile represents a human user, an API key, or a system principal.

formatenum

One of the following:

"PROFILE_TYPE_UNSPECIFIED"

"PROFILE_TYPE_USER"

"PROFILE_TYPE_API_KEY"

"PROFILE_TYPE_SYSTEM"

email: optional string

Email address of the profile. Required and unique within an account for user profiles.

Display name (e.g., “Bobby Tables”).

feedbackCount: optional number

Total number of objective feedbacks received for this variation

formatint32

memoryLayerAssignments: optional array of VariationMemoryLayerAssignment { id, memoryLayer, position }

Read-only list of memory layer assignments for this variation, returned in ascending position (bottom → top). Capped at 10 entries.

id: optional string

Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer’s id.

memoryLayer: optional BareMetadata { id, name }

id: optional 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).

position: optional number

Position in the variation’s baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation’s baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment’s position is rejected with InvalidArgument.

formatint32

memoryLayerCount: optional number

Count of memory layer assignments.

formatint32

model: optional ResourceMetadata { id, accountId, createdAt, 6 more }

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

formatdate-time

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)

bundleKey: optional 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”}

score: optional number

Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta). Range [0, 1] where 0.5 = neutral, >0.5 = positive, <0.5 = negative.

formatfloat

subAgentCount: optional number

Number of sub-agents assigned to this variation

formatint32

toolCount: optional number

Number of individual tools assigned to this variation

formatint32

toolSetCount: optional number

Number of tool sets assigned to this variation

formatint32

metadata: OperationMetadata { id, accountId, createdAt, 4 more }

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

formatdate-time

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”}

status: ObjectiveStatus { state, message }

state: "STATE_UNSPECIFIED" or "STATE_PENDING" or "STATE_RUNNING" or 4 more

formatenum

One of the following:

"STATE_UNSPECIFIED"

"STATE_PENDING"

"STATE_RUNNING"

"STATE_WAITING"

"STATE_FAILED"

"STATE_CANCELLED"

"STATE_FINALIZED"

message: optional string

info: optional ObjectiveInfo { agent, agentVariation, createdBy, 6 more }

ObjectiveInfo provides read-only aggregated statistics about an objective’s execution

agent: optional ResourceMetadata { id, accountId, createdAt, 6 more }

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

formatdate-time

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)

bundleKey: optional 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”}

agentVariation: optional ResourceMetadata { id, accountId, createdAt, 6 more }

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

formatdate-time

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)

bundleKey: optional 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”}

createdBy: optional Profile { metadata, spec }

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 { id, accountId, name, 3 more }

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)

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 { type, email, name }

Configuration for a profile.

type: "PROFILE_TYPE_UNSPECIFIED" or "PROFILE_TYPE_USER" or "PROFILE_TYPE_API_KEY" or "PROFILE_TYPE_SYSTEM"

Whether this profile represents a human user, an API key, or a system principal.

formatenum

One of the following:

"PROFILE_TYPE_UNSPECIFIED"

"PROFILE_TYPE_USER"

"PROFILE_TYPE_API_KEY"

"PROFILE_TYPE_SYSTEM"

email: optional string

Email address of the profile. Required and unique within an account for user profiles.

Display name (e.g., “Bobby Tables”).

effectiveMemoryStack: optional array of MemoryReference { memoryEntryId, memoryLayerId }

The effective memory stack at objective creation time, flattened from the variation’s baseline plus ObjectiveData.memory_stack. Order is push order (last = top). Returned on reads so clients can see exactly what stack the objective is using without having to re-join variation state.

memoryEntryId: optional string

memoryLayerId: optional string

totalContextWindows: optional number

Total number of context windows that this objective has generated

formatint32

totalEvents: optional number

Total number of events generated during this objective’s execution

formatint32

totalInputTokens: optional number

Total input tokens consumed across all LLM completions across all context windows

formatint32

totalOutputTokens: optional number

Total output tokens generated across all LLM completions across all context windows

formatint32

totalToolCalls: optional number

Total number of tool calls made during execution

formatint32

lastFiveWindows: optional array of ObjectiveContextWindow { data, metadata, info }

Read-only list of the last five windows of execution for this objective, ordered by most recent first. Is only included in singular RPC calls (GetObjective, for example).

data: ObjectiveContextWindowData { completionTokens, objectiveId, previousWindowContinueInstructions, 2 more }

completionTokens: optional number

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

formatint32

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

formatint32

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.

formatint32

metadata: OperationMetadata { id, accountId, createdAt, 4 more }

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

formatdate-time

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”}

info: optional object { createdBy, objective }

createdBy: optional Profile { metadata, spec }

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 { id, accountId, name, 3 more }

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)

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 { type, email, name }

Configuration for a profile.

type: "PROFILE_TYPE_UNSPECIFIED" or "PROFILE_TYPE_USER" or "PROFILE_TYPE_API_KEY" or "PROFILE_TYPE_SYSTEM"

Whether this profile represents a human user, an API key, or a system principal.

formatenum

One of the following:

"PROFILE_TYPE_UNSPECIFIED"

"PROFILE_TYPE_USER"

"PROFILE_TYPE_API_KEY"

"PROFILE_TYPE_SYSTEM"

email: optional string

Email address of the profile. Required and unique within an account for user profiles.

Display name (e.g., “Bobby Tables”).

objective: optional OperationMetadata { id, accountId, createdAt, 4 more }

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

formatdate-time

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”}

pagination: optional Page { nextCursor, total }

nextCursor: optional string

total: optional number

List objectives

curl https://api.cadenya.com/v1/workspaces/$WORKSPACE_ID/objectives \
    -H "Authorization: Bearer $CADENYA_API_KEY"

{
  "items": [
    {
      "data": {
        "agent": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "name": "name",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "bundleKey": "bundleKey",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "status": "AGENT_STATUS_UNSPECIFIED",
            "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED",
            "description": "description",
            "inputDataSchema": {
              "foo": "bar"
            },
            "outputDefinition": {
              "foo": "bar"
            },
            "webhookEventsUrl": "webhookEventsUrl"
          },
          "info": {
            "createdBy": {
              "metadata": {
                "id": "id",
                "accountId": "accountId",
                "name": "name",
                "profileId": "profileId",
                "externalId": "externalId",
                "labels": {
                  "foo": "string"
                }
              },
              "spec": {
                "type": "PROFILE_TYPE_UNSPECIFIED",
                "email": "email",
                "name": "name"
              }
            },
            "variationCount": 0
          }
        },
        "data": {},
        "initialMessage": "initialMessage",
        "memoryStack": [
          {
            "memoryEntryId": "memoryEntryId",
            "memoryLayerId": "memoryLayerId"
          }
        ],
        "output": {
          "foo": "bar"
        },
        "outputDefinition": {
          "foo": "bar"
        },
        "parentObjectiveId": "parentObjectiveId",
        "secrets": [
          {
            "name": "name",
            "value": "value"
          }
        ],
        "sourceScheduleId": "sourceScheduleId",
        "systemPrompt": "systemPrompt",
        "variation": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "name": "name",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "bundleKey": "bundleKey",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "compactionConfig": {
              "summarization": {
                "instructions": "instructions"
              },
              "toolResultClearing": {
                "preserveRecentResults": 0
              },
              "triggerThreshold": 0
            },
            "constraints": {
              "maxSubObjectives": 0,
              "maxToolCalls": 0
            },
            "description": "description",
            "enableEpisodicMemory": true,
            "episodicMemoryTtl": 0,
            "modelConfig": {
              "modelId": "modelId",
              "temperature": 0
            },
            "progressiveDiscovery": {
              "hints": [
                "string"
              ],
              "maxTools": 0,
              "rerankThreshold": 0
            },
            "prompt": "prompt",
            "weight": 0
          },
          "info": {
            "assignments": [
              {
                "id": "id",
                "agent": {
                  "id": "id",
                  "name": "name"
                },
                "tool": {
                  "id": "id",
                  "name": "name"
                },
                "toolSet": {
                  "id": "id",
                  "name": "name"
                }
              }
            ],
            "createdBy": {
              "metadata": {
                "id": "id",
                "accountId": "accountId",
                "name": "name",
                "profileId": "profileId",
                "externalId": "externalId",
                "labels": {
                  "foo": "string"
                }
              },
              "spec": {
                "type": "PROFILE_TYPE_UNSPECIFIED",
                "email": "email",
                "name": "name"
              }
            },
            "feedbackCount": 0,
            "memoryLayerAssignments": [
              {
                "id": "id",
                "memoryLayer": {
                  "id": "id",
                  "name": "name"
                },
                "position": 0
              }
            ],
            "memoryLayerCount": 0,
            "model": {
              "id": "id",
              "accountId": "accountId",
              "createdAt": "2019-12-27T18:11:19.117Z",
              "name": "name",
              "profileId": "profileId",
              "workspaceId": "workspaceId",
              "bundleKey": "bundleKey",
              "externalId": "externalId",
              "labels": {
                "foo": "string"
              }
            },
            "score": 0,
            "subAgentCount": 0,
            "toolCount": 0,
            "toolSetCount": 0
          }
        }
      },
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "createdAt": "2019-12-27T18:11:19.117Z",
        "profileId": "profileId",
        "workspaceId": "workspaceId",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      },
      "status": {
        "state": "STATE_UNSPECIFIED",
        "message": "message"
      },
      "info": {
        "agent": {
          "id": "id",
          "accountId": "accountId",
          "createdAt": "2019-12-27T18:11:19.117Z",
          "name": "name",
          "profileId": "profileId",
          "workspaceId": "workspaceId",
          "bundleKey": "bundleKey",
          "externalId": "externalId",
          "labels": {
            "foo": "string"
          }
        },
        "agentVariation": {
          "id": "id",
          "accountId": "accountId",
          "createdAt": "2019-12-27T18:11:19.117Z",
          "name": "name",
          "profileId": "profileId",
          "workspaceId": "workspaceId",
          "bundleKey": "bundleKey",
          "externalId": "externalId",
          "labels": {
            "foo": "string"
          }
        },
        "createdBy": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "name": "name",
            "profileId": "profileId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "type": "PROFILE_TYPE_UNSPECIFIED",
            "email": "email",
            "name": "name"
          }
        },
        "effectiveMemoryStack": [
          {
            "memoryEntryId": "memoryEntryId",
            "memoryLayerId": "memoryLayerId"
          }
        ],
        "totalContextWindows": 0,
        "totalEvents": 0,
        "totalInputTokens": 0,
        "totalOutputTokens": 0,
        "totalToolCalls": 0
      },
      "lastFiveWindows": [
        {
          "data": {
            "completionTokens": 0,
            "objectiveId": "objectiveId",
            "previousWindowContinueInstructions": "previousWindowContinueInstructions",
            "promptTokens": 0,
            "sequence": 0
          },
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "info": {
            "createdBy": {
              "metadata": {
                "id": "id",
                "accountId": "accountId",
                "name": "name",
                "profileId": "profileId",
                "externalId": "externalId",
                "labels": {
                  "foo": "string"
                }
              },
              "spec": {
                "type": "PROFILE_TYPE_UNSPECIFIED",
                "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"
              }
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": "nextCursor",
    "total": 0
  }
}

Returns Examples

{
  "items": [
    {
      "data": {
        "agent": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "name": "name",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "bundleKey": "bundleKey",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "status": "AGENT_STATUS_UNSPECIFIED",
            "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED",
            "description": "description",
            "inputDataSchema": {
              "foo": "bar"
            },
            "outputDefinition": {
              "foo": "bar"
            },
            "webhookEventsUrl": "webhookEventsUrl"
          },
          "info": {
            "createdBy": {
              "metadata": {
                "id": "id",
                "accountId": "accountId",
                "name": "name",
                "profileId": "profileId",
                "externalId": "externalId",
                "labels": {
                  "foo": "string"
                }
              },
              "spec": {
                "type": "PROFILE_TYPE_UNSPECIFIED",
                "email": "email",
                "name": "name"
              }
            },
            "variationCount": 0
          }
        },
        "data": {},
        "initialMessage": "initialMessage",
        "memoryStack": [
          {
            "memoryEntryId": "memoryEntryId",
            "memoryLayerId": "memoryLayerId"
          }
        ],
        "output": {
          "foo": "bar"
        },
        "outputDefinition": {
          "foo": "bar"
        },
        "parentObjectiveId": "parentObjectiveId",
        "secrets": [
          {
            "name": "name",
            "value": "value"
          }
        ],
        "sourceScheduleId": "sourceScheduleId",
        "systemPrompt": "systemPrompt",
        "variation": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "name": "name",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "bundleKey": "bundleKey",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "compactionConfig": {
              "summarization": {
                "instructions": "instructions"
              },
              "toolResultClearing": {
                "preserveRecentResults": 0
              },
              "triggerThreshold": 0
            },
            "constraints": {
              "maxSubObjectives": 0,
              "maxToolCalls": 0
            },
            "description": "description",
            "enableEpisodicMemory": true,
            "episodicMemoryTtl": 0,
            "modelConfig": {
              "modelId": "modelId",
              "temperature": 0
            },
            "progressiveDiscovery": {
              "hints": [
                "string"
              ],
              "maxTools": 0,
              "rerankThreshold": 0
            },
            "prompt": "prompt",
            "weight": 0
          },
          "info": {
            "assignments": [
              {
                "id": "id",
                "agent": {
                  "id": "id",
                  "name": "name"
                },
                "tool": {
                  "id": "id",
                  "name": "name"
                },
                "toolSet": {
                  "id": "id",
                  "name": "name"
                }
              }
            ],
            "createdBy": {
              "metadata": {
                "id": "id",
                "accountId": "accountId",
                "name": "name",
                "profileId": "profileId",
                "externalId": "externalId",
                "labels": {
                  "foo": "string"
                }
              },
              "spec": {
                "type": "PROFILE_TYPE_UNSPECIFIED",
                "email": "email",
                "name": "name"
              }
            },
            "feedbackCount": 0,
            "memoryLayerAssignments": [
              {
                "id": "id",
                "memoryLayer": {
                  "id": "id",
                  "name": "name"
                },
                "position": 0
              }
            ],
            "memoryLayerCount": 0,
            "model": {
              "id": "id",
              "accountId": "accountId",
              "createdAt": "2019-12-27T18:11:19.117Z",
              "name": "name",
              "profileId": "profileId",
              "workspaceId": "workspaceId",
              "bundleKey": "bundleKey",
              "externalId": "externalId",
              "labels": {
                "foo": "string"
              }
            },
            "score": 0,
            "subAgentCount": 0,
            "toolCount": 0,
            "toolSetCount": 0
          }
        }
      },
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "createdAt": "2019-12-27T18:11:19.117Z",
        "profileId": "profileId",
        "workspaceId": "workspaceId",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      },
      "status": {
        "state": "STATE_UNSPECIFIED",
        "message": "message"
      },
      "info": {
        "agent": {
          "id": "id",
          "accountId": "accountId",
          "createdAt": "2019-12-27T18:11:19.117Z",
          "name": "name",
          "profileId": "profileId",
          "workspaceId": "workspaceId",
          "bundleKey": "bundleKey",
          "externalId": "externalId",
          "labels": {
            "foo": "string"
          }
        },
        "agentVariation": {
          "id": "id",
          "accountId": "accountId",
          "createdAt": "2019-12-27T18:11:19.117Z",
          "name": "name",
          "profileId": "profileId",
          "workspaceId": "workspaceId",
          "bundleKey": "bundleKey",
          "externalId": "externalId",
          "labels": {
            "foo": "string"
          }
        },
        "createdBy": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "name": "name",
            "profileId": "profileId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "type": "PROFILE_TYPE_UNSPECIFIED",
            "email": "email",
            "name": "name"
          }
        },
        "effectiveMemoryStack": [
          {
            "memoryEntryId": "memoryEntryId",
            "memoryLayerId": "memoryLayerId"
          }
        ],
        "totalContextWindows": 0,
        "totalEvents": 0,
        "totalInputTokens": 0,
        "totalOutputTokens": 0,
        "totalToolCalls": 0
      },
      "lastFiveWindows": [
        {
          "data": {
            "completionTokens": 0,
            "objectiveId": "objectiveId",
            "previousWindowContinueInstructions": "previousWindowContinueInstructions",
            "promptTokens": 0,
            "sequence": 0
          },
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "info": {
            "createdBy": {
              "metadata": {
                "id": "id",
                "accountId": "accountId",
                "name": "name",
                "profileId": "profileId",
                "externalId": "externalId",
                "labels": {
                  "foo": "string"
                }
              },
              "spec": {
                "type": "PROFILE_TYPE_UNSPECIFIED",
                "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"
              }
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": "nextCursor",
    "total": 0
  }
}