List objectives

client.Objectives.List(ctx, query) (*CursorPagination[Objective], error)

GET/v1/objectives

Lists all objectives in the workspace

ParametersExpand Collapse

query ObjectiveListParams

AgentID param.Field[string]optional

Agent ID for filtering

Cursor param.Field[string]optional

Pagination cursor from previous response

IncludeInfo param.Field[bool]optional

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

Limit param.Field[int64]optional

Maximum number of results to return

formatint32

ParentObjectiveID param.Field[string]optional

Optional filters

ProfileID param.Field[string]optional

SortOrder param.Field[string]optional

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

State param.Field[ObjectiveListParamsState]optional

Filter by state

formatenum

const ObjectiveListParamsStateStateUnspecified ObjectiveListParamsState = "STATE_UNSPECIFIED"

const ObjectiveListParamsStateStatePending ObjectiveListParamsState = "STATE_PENDING"

const ObjectiveListParamsStateStateRunning ObjectiveListParamsState = "STATE_RUNNING"

const ObjectiveListParamsStateStateCompleted ObjectiveListParamsState = "STATE_COMPLETED"

const ObjectiveListParamsStateStateFailed ObjectiveListParamsState = "STATE_FAILED"

const ObjectiveListParamsStateStateCancelled ObjectiveListParamsState = "STATE_CANCELLED"

ReturnsExpand Collapse

type Objective struct{…}

Data ObjectiveData

Agent Agentoptional

Agent resource

Metadata 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 Time

Timestamp when this resource was created

formatdate-time

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 stringoptional

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

Labels map[string, string]optional

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

Spec AgentSpec

Agent specification (user-provided configuration)

Status AgentSpecStatus

Status of the agent

formatenum

One of the following:

const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"

const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"

const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"

const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"

VariationSelectionMode AgentSpecVariationSelectionMode

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

formatenum

One of the following:

const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"

const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"

const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"

Description stringoptional

Description of the agent's purpose

WebhookEventsURL stringoptional

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

Info AgentInfooptional

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

CreatedBy Profileoptional

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 stringoptional

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

Labels map[string, string]optional

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

Spec ProfileSpec

ProfileSpec contains the profile-specific fields

Type ProfileSpecType

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

formatenum

One of the following:

const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"

const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"

const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"

Email stringoptional

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

Name stringoptional

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

VariationCount int64optional

Data unknownoptional

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 stringoptional

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

ParentObjectiveID stringoptional

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

Secrets []ObjectiveDataSecretoptional

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

Name stringoptional

Value stringoptional

SystemPrompt stringoptional

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

Variation AgentVariationoptional

AgentVariation resource

Metadata 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 Time

Timestamp when this resource was created

formatdate-time

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 stringoptional

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

Labels map[string, string]optional

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

Spec AgentVariationSpec

AgentVariationSpec defines the operational configuration for a variation

CompactionConfig AgentVariationSpecCompactionConfigoptional

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

Summarization CompactionConfigSummarizationStrategyoptional

SummarizationStrategy configures LLM-powered summarization of older conversation turns.

Instructions stringoptional

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 CompactionConfigToolResultClearingStrategyoptional

ToolResultClearingStrategy configures clearing of older tool result content.

PreserveRecentResults int64optional

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 float64optional

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 AgentVariationSpecConstraintsoptional

Execution constraints

MaxSubObjectives int64optional

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

formatint32

MaxToolCalls int64optional

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

formatint32

Description stringoptional

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

EnableEpisodicMemory booloptional

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 int64optional

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 AgentVariationSpecModelConfigoptional

ModelConfig defines the model configuration for a variation

ModelID stringoptional

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

Temperature float64optional

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

formatfloat

Prompt stringoptional

The system prompt for this variation

ToolSelection AgentVariationSpecToolSelectionoptional

Tool selection strategy

AssignedTools ToolSelectionAssignedToolsoptional

AssignedTools is used to indicate that the agent should only use the tools/tool sets that are explicitly assigned to it. Allow discovery is used when the agent thinks it needs to discover more tools.

AllowDiscovery booloptional

AutoDiscovery ToolSelectionAutoDiscoveryoptional

AutoDiscovery 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. 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 []stringoptional

MaxTools int64optional

Weight int64optional

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 AgentVariationInfooptional

AgentVariationInfo provides read-only summary information about a variation

Assignments []VariationAssignmentoptional

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 stringoptional

Agent BareMetadataoptional

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 stringoptional

Name stringoptional

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 BareMetadataoptional

ID stringoptional

Name stringoptional

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 BareMetadataoptional

ID stringoptional

Name stringoptional

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 Profileoptional

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 stringoptional

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

Labels map[string, string]optional

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

Spec ProfileSpec

ProfileSpec contains the profile-specific fields

Type ProfileSpecType

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

formatenum

One of the following:

const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"

const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"

const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"

Email stringoptional

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

Name stringoptional

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

FeedbackCount int64optional

Total number of objective feedbacks received for this variation

formatint32

Model ResourceMetadataoptional

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 Time

Timestamp when this resource was created

formatdate-time

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 stringoptional

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

Labels map[string, string]optional

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

Score float64optional

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 int64optional

Number of sub-agents assigned to this variation

formatint32

ToolCount int64optional

Number of individual tools assigned to this variation

formatint32

ToolSetCount int64optional

Number of tool sets assigned to this variation

formatint32

Metadata 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 Time

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 stringoptional

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

Labels map[string, string]optional

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

Status ObjectiveStatus

State ObjectiveStatusState

formatenum

One of the following:

const ObjectiveStatusStateStateUnspecified ObjectiveStatusState = "STATE_UNSPECIFIED"

const ObjectiveStatusStateStatePending ObjectiveStatusState = "STATE_PENDING"

const ObjectiveStatusStateStateRunning ObjectiveStatusState = "STATE_RUNNING"

const ObjectiveStatusStateStateCompleted ObjectiveStatusState = "STATE_COMPLETED"

const ObjectiveStatusStateStateFailed ObjectiveStatusState = "STATE_FAILED"

const ObjectiveStatusStateStateCancelled ObjectiveStatusState = "STATE_CANCELLED"

Message stringoptional

Info ObjectiveInfooptional

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

CallableTools []CallableTooloptional

List of callable tools assigned to the agent for this objective Includes tools, agents, and cadenya-provided tools from the agent's configuration

Agent ResourceMetadataoptional

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 Time

Timestamp when this resource was created

formatdate-time

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 stringoptional

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

Labels map[string, string]optional

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

CadenyaProvidedTool ResourceMetadataoptional

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 Time

Timestamp when this resource was created

formatdate-time

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 stringoptional

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

Labels map[string, string]optional

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

Tool ResourceMetadataoptional

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 Time

Timestamp when this resource was created

formatdate-time

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 stringoptional

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

Labels map[string, string]optional

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

CreatedBy Profileoptional

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 stringoptional

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

Labels map[string, string]optional

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

Spec ProfileSpec

ProfileSpec contains the profile-specific fields

Type ProfileSpecType

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

formatenum

One of the following:

const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"

const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"

const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"

Email stringoptional

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

Name stringoptional

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

TotalContextWindows int64optional

Total number of context windows that this objective has generated

formatint32

TotalEvents int64optional

Total number of events generated during this objective's execution

formatint32

TotalInputTokens int64optional

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

formatint32

TotalOutputTokens int64optional

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

formatint32

TotalToolCalls int64optional

Total number of tool calls made during execution

formatint32

LastFiveWindows []ObjectiveContextWindowoptional

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 int64optional

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

formatint32

ObjectiveID stringoptional

The objective's ID that this window belongs to

PreviousWindowContinueInstructions stringoptional

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

PromptTokens int64optional

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

formatint32

Sequence int64optional

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

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 Time

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 stringoptional

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

Labels map[string, string]optional

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

Info ObjectiveContextWindowInfooptional

CreatedBy Profileoptional

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 stringoptional

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

Labels map[string, string]optional

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

Spec ProfileSpec

ProfileSpec contains the profile-specific fields

Type ProfileSpecType

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

formatenum

One of the following:

const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"

const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"

const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"

Email stringoptional

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

Name stringoptional

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

Objective OperationMetadataoptional

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 Time

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 stringoptional

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

Labels map[string, string]optional

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

List objectives

package main

import (
  "context"
  "fmt"

  "github.com/cadenya/cadenya-go"
  "github.com/cadenya/cadenya-go/option"
)

func main() {
  client := cadenya.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.Objectives.List(context.TODO(), cadenya.ObjectiveListParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

{
  "items": [
    {
      "data": {
        "agent": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "name": "name",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "status": "AGENT_STATUS_UNSPECIFIED",
            "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED",
            "description": "description",
            "webhookEventsUrl": "webhookEventsUrl"
          },
          "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"
              }
            },
            "variationCount": 0
          }
        },
        "data": {},
        "initialMessage": "initialMessage",
        "parentObjectiveId": "parentObjectiveId",
        "secrets": [
          {
            "name": "name",
            "value": "value"
          }
        ],
        "systemPrompt": "systemPrompt",
        "variation": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "name": "name",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "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
            },
            "prompt": "prompt",
            "toolSelection": {
              "assignedTools": {
                "allowDiscovery": true
              },
              "autoDiscovery": {
                "hints": [
                  "string"
                ],
                "maxTools": 0
              }
            },
            "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_USER",
                "email": "email",
                "name": "name"
              }
            },
            "feedbackCount": 0,
            "model": {
              "id": "id",
              "accountId": "accountId",
              "createdAt": "2019-12-27T18:11:19.117Z",
              "name": "name",
              "profileId": "profileId",
              "workspaceId": "workspaceId",
              "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": {
        "callableTools": [
          {
            "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"
              }
            }
          }
        ],
        "createdBy": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "name": "name",
            "profileId": "profileId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "type": "PROFILE_TYPE_USER",
            "email": "email",
            "name": "name"
          }
        },
        "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_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"
              }
            }
          }
        }
      ]
    }
  ],
  "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",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "status": "AGENT_STATUS_UNSPECIFIED",
            "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED",
            "description": "description",
            "webhookEventsUrl": "webhookEventsUrl"
          },
          "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"
              }
            },
            "variationCount": 0
          }
        },
        "data": {},
        "initialMessage": "initialMessage",
        "parentObjectiveId": "parentObjectiveId",
        "secrets": [
          {
            "name": "name",
            "value": "value"
          }
        ],
        "systemPrompt": "systemPrompt",
        "variation": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "createdAt": "2019-12-27T18:11:19.117Z",
            "name": "name",
            "profileId": "profileId",
            "workspaceId": "workspaceId",
            "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
            },
            "prompt": "prompt",
            "toolSelection": {
              "assignedTools": {
                "allowDiscovery": true
              },
              "autoDiscovery": {
                "hints": [
                  "string"
                ],
                "maxTools": 0
              }
            },
            "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_USER",
                "email": "email",
                "name": "name"
              }
            },
            "feedbackCount": 0,
            "model": {
              "id": "id",
              "accountId": "accountId",
              "createdAt": "2019-12-27T18:11:19.117Z",
              "name": "name",
              "profileId": "profileId",
              "workspaceId": "workspaceId",
              "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": {
        "callableTools": [
          {
            "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"
              }
            }
          }
        ],
        "createdBy": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "name": "name",
            "profileId": "profileId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "type": "PROFILE_TYPE_USER",
            "email": "email",
            "name": "name"
          }
        },
        "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_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"
              }
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": "nextCursor",
    "total": 0
  }
}