Apply a workspace resource bundle

POST/v1/workspaces/{workspaceId}/bulk_workspace_applies

Asynchronously applies a declarative bundle of workspace resources. Returns the operation immediately in PENDING; clients poll Get to track progress.

Path ParametersExpand Collapse

workspaceId: string

Body ParametersJSONExpand Collapse

data: BulkWorkspaceApplyData { bundleKey, agents, automaticallyPublishAgents, 3 more }

bundleKey: string

Required. Bundle ownership key. Resources created or updated by an Apply have their metadata.bundle_key set to this value. On subsequent applies with the same bundle_key, resources currently bearing this bundle_key but absent from the spec are soft-deleted.

agents: optional map[AgentEntry { name, spec, labels, 2 more } ]

Agents to upsert, keyed by external_id.

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.

labels: optional map[string]

schedules: optional map[AgentScheduleEntry { name, spec, labels } ]

Schedules under this agent, keyed by external_id.

spec: AgentScheduleSpec { initialMessage, schedule, data, 3 more }

AgentScheduleSpec is the user-provided configuration for a schedule.

initialMessage: string

The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective’s chat history.

schedule: AgentScheduleSpecSchedule { calendars, intervals, timezone }

Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR’d together. At least one rule is required.

calendars: optional array of ScheduleCalendar { comment, dayOfMonth, dayOfWeek, 4 more }

Wall-clock rules. May be empty if intervals is non-empty.

comment: optional string

dayOfMonth: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

dayOfWeek: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

hour: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

minute: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

month: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

second: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

intervals: optional array of ScheduleInterval { every, offset }

Duration-based rules. May be empty if calendars is non-empty.

every: optional string

offset: optional string

Phase shift within every. Must be < every (enforced at runtime).

timezone: optional string

IANA tz name (e.g. “America/New_York”). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone.

data: optional unknown

Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it.

overlapPolicy: optional "OVERLAP_POLICY_UNSPECIFIED" or "OVERLAP_POLICY_ALLOW" or "OVERLAP_POLICY_SKIP"

What to do when the previous run is still in flight. Defaults to SKIP.

formatenum

One of the following:

"OVERLAP_POLICY_UNSPECIFIED"

"OVERLAP_POLICY_ALLOW"

"OVERLAP_POLICY_SKIP"

status: optional "AGENT_SCHEDULE_STATUS_UNSPECIFIED" or "AGENT_SCHEDULE_STATUS_ACTIVE" or "AGENT_SCHEDULE_STATUS_PAUSED" or "AGENT_SCHEDULE_STATUS_ARCHIVED"

Lifecycle. Defaults to ACTIVE on create when unspecified.

formatenum

One of the following:

"AGENT_SCHEDULE_STATUS_UNSPECIFIED"

"AGENT_SCHEDULE_STATUS_ACTIVE"

"AGENT_SCHEDULE_STATUS_PAUSED"

"AGENT_SCHEDULE_STATUS_ARCHIVED"

variationId: optional string

Optional explicit variation. When unset, the agent’s variation_selection_mode chooses per fire.

labels: optional map[string]

variations: optional map[AgentVariationEntry { name, spec, assignments, 2 more } ]

Variations under this agent, keyed by external_id.

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

assignments: optional array of VariationAssignmentEntry { subAgentId, toolId, toolSetId }

Reconciled list — server adjusts the variation’s assignments to exactly this set when the variation is bundle-owned.

subAgentId: optional string

toolId: optional string

toolSetId: optional string

labels: optional map[string]

memoryLayers: optional array of VariationMemoryLayerEntry { memoryLayerId, position }

Reconciled list of memory layer assignments. Up to 10 entries.

memoryLayerId: optional string

external_id: form. Canonical IDs are rejected.

position: optional number

automaticallyPublishAgents: optional boolean

When true, every agent created or updated by this Apply has its status forced to AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent’s AgentSpec. Useful when the bundle represents a production configuration and you want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on each entry.

Default false: each agent’s AgentSpec.status controls (which is AGENT_STATUS_DRAFT on create when unspecified).

memoryLayers: optional map[MemoryLayerEntry { name, spec, entries, labels } ]

Memory layers to upsert, keyed by external_id.

spec: MemoryLayerSpec { type, description, expiresAt, systemManaged }

type: "MEMORY_LAYER_TYPE_UNSPECIFIED" or "MEMORY_LAYER_TYPE_EPISODIC" or "MEMORY_LAYER_TYPE_SKILLS"

formatenum

One of the following:

"MEMORY_LAYER_TYPE_UNSPECIFIED"

"MEMORY_LAYER_TYPE_EPISODIC"

"MEMORY_LAYER_TYPE_SKILLS"

description: optional string

Human-readable description of the layer’s purpose. Encouraged for user-created layers; system-managed layers may have a generated description.

expiresAt: optional string

For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers.

formatdate-time

systemManaged: optional boolean

Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime.

entries: optional map[MemoryEntryItem { key, content, description, uploadId } ]

Memory entries in this layer, keyed by external_id.

key: string

content: optional string

description: optional string

uploadId: optional string

labels: optional map[string]

sourceUrl: optional string

Optional URL pointing to the source of this apply (GitHub PR, Jenkins build, GitLab pipeline, etc.). Surfaced in the dashboard so users can jump from an apply back to the change that produced it. Free-form HTTPS URI; not interpreted by the server.

toolSets: optional map[ToolSetEntry { name, spec, labels, tools } ]

Tool sets to upsert, keyed by external_id.

spec: ToolSetSpec { adapter, description }

adapter: optional ToolSetAdapter { http, mcp, openapi }

http: optional ToolSetAdapterHTTP { baseUrl, headers }

baseUrl: optional string

headers: optional map[string]

mcp: optional ToolSetAdapterMcp { excludeTools, headers, includeTools, 2 more }

excludeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

headers: optional map[string]

includeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

toolApprovals: optional ApprovalRequirementFilter { always, only }

Approval filters that will automatically set the approval requirement on tools synced from an external source

always: optional boolean

only: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

url: optional string

openapi: optional ToolSetAdapterOpenAPI { baseUrl, excludeTools, headers, 5 more }

baseUrl: optional string

Base URL for dispatching tool calls. If set, overrides the server resolved from the spec’s servers array.

excludeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

headers: optional map[string]

Headers sent when fetching the spec from a URL and when dispatching tool calls.

includeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

serverName: optional string

Name of the server entry in the spec’s servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set.

toolApprovals: optional ApprovalRequirementFilter { always, only }

Approval filters that will automatically set the approval requirement on tools synced from an external source

always: optional boolean

only: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

uploadId: optional string

ID of a COMPLETE Upload containing the OpenAPI spec document.

url: optional string

URL to fetch the OpenAPI spec from. Synced automatically every hour.

description: optional string

labels: optional map[string]

tools: optional map[ToolEntry { name, spec, labels } ]

Tools in this tool set, keyed by external_id.

spec: ToolSpec { config, description, parameters, 2 more }

config: ToolSpecConfig { http, mcp, openapi }

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.

http: optional ConfigHTTP { requestMethod, headers, path, 4 more }

requestMethod: "HTTP_METHOD_UNSPECIFIED" or "GET" or "POST" or 3 more

formatenum

One of the following:

"HTTP_METHOD_UNSPECIFIED"

"GET"

"POST"

"PUT"

"PATCH"

"DELETE"

headers: optional map[string]

path: optional string

query: optional string

requestBodyContentType: optional string

requestBodyTemplate: optional string

These are only used when the request method is a POST, PUT, or PATCH

toolName: optional string

The tool name (commonly an “operation id” in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided.

mcp: optional ConfigMcp { toolDescription, toolName, toolTitle }

toolDescription: optional string

toolName: optional string

toolTitle: optional string

openapi: optional ConfigOpenAPI { method, operationId, path }

method: optional string

operationId: optional string

path: optional string

description: string

parameters: map[unknown]

status: "TOOL_STATUS_UNSPECIFIED" or "TOOL_STATUS_AVAILABLE" or "TOOL_STATUS_OMITTED" or "TOOL_STATUS_ARCHIVED"

formatenum

One of the following:

"TOOL_STATUS_UNSPECIFIED"

"TOOL_STATUS_AVAILABLE"

"TOOL_STATUS_OMITTED"

"TOOL_STATUS_ARCHIVED"

requiresApproval: optional boolean

labels: optional map[string]

ReturnsExpand Collapse

BulkWorkspaceApply object { data, metadata, status, info }

The operation resource produced by a call to BulkWorkspaceResources.Apply. It carries the input bundle in data, the lifecycle state in status, and aggregate counts in info.

data: BulkWorkspaceApplyData { bundleKey, agents, automaticallyPublishAgents, 3 more }

bundleKey: string

agents: optional map[AgentEntry { name, spec, labels, 2 more } ]

Agents to upsert, keyed by external_id.

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]

outputDefinition: optional map[unknown]

webhookEventsUrl: optional string

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

labels: optional map[string]

schedules: optional map[AgentScheduleEntry { name, spec, labels } ]

Schedules under this agent, keyed by external_id.

spec: AgentScheduleSpec { initialMessage, schedule, data, 3 more }

AgentScheduleSpec is the user-provided configuration for a schedule.

initialMessage: string

The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective’s chat history.

schedule: AgentScheduleSpecSchedule { calendars, intervals, timezone }

Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR’d together. At least one rule is required.

calendars: optional array of ScheduleCalendar { comment, dayOfMonth, dayOfWeek, 4 more }

Wall-clock rules. May be empty if intervals is non-empty.

comment: optional string

dayOfMonth: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

dayOfWeek: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

hour: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

minute: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

month: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

second: optional array of ScheduleRange { end, start, step }

end: optional number

start: optional number

step: optional number

intervals: optional array of ScheduleInterval { every, offset }

Duration-based rules. May be empty if calendars is non-empty.

every: optional string

offset: optional string

Phase shift within every. Must be < every (enforced at runtime).

timezone: optional string

IANA tz name (e.g. “America/New_York”). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone.

data: optional unknown

Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it.

overlapPolicy: optional "OVERLAP_POLICY_UNSPECIFIED" or "OVERLAP_POLICY_ALLOW" or "OVERLAP_POLICY_SKIP"

What to do when the previous run is still in flight. Defaults to SKIP.

formatenum

One of the following:

"OVERLAP_POLICY_UNSPECIFIED"

"OVERLAP_POLICY_ALLOW"

"OVERLAP_POLICY_SKIP"

status: optional "AGENT_SCHEDULE_STATUS_UNSPECIFIED" or "AGENT_SCHEDULE_STATUS_ACTIVE" or "AGENT_SCHEDULE_STATUS_PAUSED" or "AGENT_SCHEDULE_STATUS_ARCHIVED"

Lifecycle. Defaults to ACTIVE on create when unspecified.

formatenum

One of the following:

"AGENT_SCHEDULE_STATUS_UNSPECIFIED"

"AGENT_SCHEDULE_STATUS_ACTIVE"

"AGENT_SCHEDULE_STATUS_PAUSED"

"AGENT_SCHEDULE_STATUS_ARCHIVED"

variationId: optional string

Optional explicit variation. When unset, the agent’s variation_selection_mode chooses per fire.

labels: optional map[string]

variations: optional map[AgentVariationEntry { name, spec, assignments, 2 more } ]

Variations under this agent, keyed by external_id.

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

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

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 }

hints: optional array of string

maxTools: optional number

rerankThreshold: optional number

formatfloat

prompt: optional string

The system prompt for this variation

weight: optional number

formatint32

assignments: optional array of VariationAssignmentEntry { subAgentId, toolId, toolSetId }

Reconciled list — server adjusts the variation’s assignments to exactly this set when the variation is bundle-owned.

subAgentId: optional string

toolId: optional string

toolSetId: optional string

labels: optional map[string]

memoryLayers: optional array of VariationMemoryLayerEntry { memoryLayerId, position }

Reconciled list of memory layer assignments. Up to 10 entries.

memoryLayerId: optional string

external_id: form. Canonical IDs are rejected.

position: optional number

automaticallyPublishAgents: optional boolean

Default false: each agent’s AgentSpec.status controls (which is AGENT_STATUS_DRAFT on create when unspecified).

memoryLayers: optional map[MemoryLayerEntry { name, spec, entries, labels } ]

Memory layers to upsert, keyed by external_id.

spec: MemoryLayerSpec { type, description, expiresAt, systemManaged }

type: "MEMORY_LAYER_TYPE_UNSPECIFIED" or "MEMORY_LAYER_TYPE_EPISODIC" or "MEMORY_LAYER_TYPE_SKILLS"

formatenum

One of the following:

"MEMORY_LAYER_TYPE_UNSPECIFIED"

"MEMORY_LAYER_TYPE_EPISODIC"

"MEMORY_LAYER_TYPE_SKILLS"

description: optional string

Human-readable description of the layer’s purpose. Encouraged for user-created layers; system-managed layers may have a generated description.

expiresAt: optional string

For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers.

formatdate-time

systemManaged: optional boolean

entries: optional map[MemoryEntryItem { key, content, description, uploadId } ]

Memory entries in this layer, keyed by external_id.

key: string

content: optional string

description: optional string

uploadId: optional string

labels: optional map[string]

sourceUrl: optional string

toolSets: optional map[ToolSetEntry { name, spec, labels, tools } ]

Tool sets to upsert, keyed by external_id.

spec: ToolSetSpec { adapter, description }

adapter: optional ToolSetAdapter { http, mcp, openapi }

http: optional ToolSetAdapterHTTP { baseUrl, headers }

baseUrl: optional string

headers: optional map[string]

mcp: optional ToolSetAdapterMcp { excludeTools, headers, includeTools, 2 more }

excludeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

headers: optional map[string]

includeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

toolApprovals: optional ApprovalRequirementFilter { always, only }

Approval filters that will automatically set the approval requirement on tools synced from an external source

always: optional boolean

only: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

url: optional string

openapi: optional ToolSetAdapterOpenAPI { baseUrl, excludeTools, headers, 5 more }

baseUrl: optional string

Base URL for dispatching tool calls. If set, overrides the server resolved from the spec’s servers array.

excludeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

headers: optional map[string]

Headers sent when fetching the spec from a URL and when dispatching tool calls.

includeTools: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

serverName: optional string

toolApprovals: optional ApprovalRequirementFilter { always, only }

Approval filters that will automatically set the approval requirement on tools synced from an external source

always: optional boolean

only: optional ToolFilter { operator, filters }

Top-level filter with simple boolean logic (no nesting)

operator: "OPERATOR_UNSPECIFIED" or "OPERATOR_AND" or "OPERATOR_OR"

formatenum

One of the following:

"OPERATOR_UNSPECIFIED"

"OPERATOR_AND"

"OPERATOR_OR"

filters: optional array of AttributeFilter { attribute, matcher }

formatenum

One of the following:

String matching operations

uploadId: optional string

ID of a COMPLETE Upload containing the OpenAPI spec document.

url: optional string

URL to fetch the OpenAPI spec from. Synced automatically every hour.

description: optional string

labels: optional map[string]

tools: optional map[ToolEntry { name, spec, labels } ]

Tools in this tool set, keyed by external_id.

spec: ToolSpec { config, description, parameters, 2 more }

config: ToolSpecConfig { http, mcp, openapi }

http: optional ConfigHTTP { requestMethod, headers, path, 4 more }

requestMethod: "HTTP_METHOD_UNSPECIFIED" or "GET" or "POST" or 3 more

formatenum

One of the following:

"HTTP_METHOD_UNSPECIFIED"

"GET"

"POST"

"PUT"

"PATCH"

"DELETE"

headers: optional map[string]

path: optional string

query: optional string

requestBodyContentType: optional string

requestBodyTemplate: optional string

These are only used when the request method is a POST, PUT, or PATCH

toolName: optional string

mcp: optional ConfigMcp { toolDescription, toolName, toolTitle }

toolDescription: optional string

toolName: optional string

toolTitle: optional string

openapi: optional ConfigOpenAPI { method, operationId, path }

method: optional string

operationId: optional string

path: optional string

description: string

parameters: map[unknown]

status: "TOOL_STATUS_UNSPECIFIED" or "TOOL_STATUS_AVAILABLE" or "TOOL_STATUS_OMITTED" or "TOOL_STATUS_ARCHIVED"

formatenum

One of the following:

"TOOL_STATUS_UNSPECIFIED"

"TOOL_STATUS_AVAILABLE"

"TOOL_STATUS_OMITTED"

"TOOL_STATUS_ARCHIVED"

requiresApproval: optional boolean

labels: optional map[string]

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: BulkWorkspaceApplyStatus { state, message, preflightError }

state: "STATE_UNSPECIFIED" or "STATE_PENDING" or "STATE_VALIDATING" or 5 more

formatenum

One of the following:

"STATE_UNSPECIFIED"

"STATE_PENDING"

"STATE_VALIDATING"

"STATE_RUNNING"

"STATE_SUCCEEDED"

"STATE_PARTIALLY_APPLIED"

"STATE_FAILED"

"STATE_CANCELLED"

message: optional string

preflightError: optional object { code, details, message }

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.

code: optional number

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

formatint32

details: optional array of object { "@type" }

A list of messages that carry the error details. There is a common set of message types for APIs to use.

"@type": optional string

The type of the serialized message.

message: optional string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

info: optional BulkWorkspaceApplyInfo { completedAt, createdBy, createdCount, 6 more }

completedAt: optional string

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”).

createdCount: optional number

deletedCount: optional number

failedCount: optional number

startedAt: optional string

totalCount: optional number

unchangedCount: optional number

updatedCount: optional number

Apply a workspace resource bundle

curl https://api.cadenya.com/v1/workspaces/$WORKSPACE_ID/bulk_workspace_applies \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CADENYA_API_KEY" \
    -d '{
          "data": {
            "bundleKey": "bundleKey"
          }
        }'

{
  "data": {
    "bundleKey": "bundleKey",
    "agents": {
      "foo": {
        "name": "name",
        "spec": {
          "status": "AGENT_STATUS_UNSPECIFIED",
          "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED",
          "description": "description",
          "inputDataSchema": {
            "foo": "bar"
          },
          "outputDefinition": {
            "foo": "bar"
          },
          "webhookEventsUrl": "webhookEventsUrl"
        },
        "labels": {
          "foo": "string"
        },
        "schedules": {
          "foo": {
            "name": "name",
            "spec": {
              "initialMessage": "initialMessage",
              "schedule": {
                "calendars": [
                  {
                    "comment": "comment",
                    "dayOfMonth": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "dayOfWeek": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "hour": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "minute": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "month": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "second": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ]
                  }
                ],
                "intervals": [
                  {
                    "every": "-160513s",
                    "offset": "-160513s"
                  }
                ],
                "timezone": "timezone"
              },
              "data": {},
              "overlapPolicy": "OVERLAP_POLICY_UNSPECIFIED",
              "status": "AGENT_SCHEDULE_STATUS_UNSPECIFIED",
              "variationId": "variationId"
            },
            "labels": {
              "foo": "string"
            }
          }
        },
        "variations": {
          "foo": {
            "name": "name",
            "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
            },
            "assignments": [
              {
                "subAgentId": "subAgentId",
                "toolId": "toolId",
                "toolSetId": "toolSetId"
              }
            ],
            "labels": {
              "foo": "string"
            },
            "memoryLayers": [
              {
                "memoryLayerId": "memoryLayerId",
                "position": 0
              }
            ]
          }
        }
      }
    },
    "automaticallyPublishAgents": true,
    "memoryLayers": {
      "foo": {
        "name": "name",
        "spec": {
          "type": "MEMORY_LAYER_TYPE_UNSPECIFIED",
          "description": "description",
          "expiresAt": "2019-12-27T18:11:19.117Z",
          "systemManaged": true
        },
        "entries": {
          "foo": {
            "key": "key",
            "content": "content",
            "description": "description",
            "uploadId": "uploadId"
          }
        },
        "labels": {
          "foo": "string"
        }
      }
    },
    "sourceUrl": "sourceUrl",
    "toolSets": {
      "foo": {
        "name": "name",
        "spec": {
          "adapter": {
            "http": {
              "baseUrl": "baseUrl",
              "headers": {
                "foo": "string"
              }
            },
            "mcp": {
              "excludeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "headers": {
                "foo": "string"
              },
              "includeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "toolApprovals": {
                "always": true,
                "only": {
                  "operator": "OPERATOR_UNSPECIFIED",
                  "filters": [
                    {
                      "attribute": "ATTRIBUTE_UNSPECIFIED",
                      "matcher": {
                        "caseSensitive": true,
                        "contains": "contains",
                        "endsWith": "endsWith",
                        "exact": "exact",
                        "regex": "regex",
                        "startsWith": "startsWith"
                      }
                    }
                  ]
                }
              },
              "url": "url"
            },
            "openapi": {
              "baseUrl": "baseUrl",
              "excludeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "headers": {
                "foo": "string"
              },
              "includeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "serverName": "serverName",
              "toolApprovals": {
                "always": true,
                "only": {
                  "operator": "OPERATOR_UNSPECIFIED",
                  "filters": [
                    {
                      "attribute": "ATTRIBUTE_UNSPECIFIED",
                      "matcher": {
                        "caseSensitive": true,
                        "contains": "contains",
                        "endsWith": "endsWith",
                        "exact": "exact",
                        "regex": "regex",
                        "startsWith": "startsWith"
                      }
                    }
                  ]
                }
              },
              "uploadId": "uploadId",
              "url": "url"
            }
          },
          "description": "description"
        },
        "labels": {
          "foo": "string"
        },
        "tools": {
          "foo": {
            "name": "name",
            "spec": {
              "config": {
                "http": {
                  "requestMethod": "HTTP_METHOD_UNSPECIFIED",
                  "headers": {
                    "foo": "string"
                  },
                  "path": "path",
                  "query": "query",
                  "requestBodyContentType": "requestBodyContentType",
                  "requestBodyTemplate": "requestBodyTemplate",
                  "toolName": "toolName"
                },
                "mcp": {
                  "toolDescription": "toolDescription",
                  "toolName": "toolName",
                  "toolTitle": "toolTitle"
                },
                "openapi": {
                  "method": "method",
                  "operationId": "operationId",
                  "path": "path"
                }
              },
              "description": "description",
              "parameters": {
                "foo": "bar"
              },
              "status": "TOOL_STATUS_UNSPECIFIED",
              "requiresApproval": true
            },
            "labels": {
              "foo": "string"
            }
          }
        }
      }
    }
  },
  "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",
    "preflightError": {
      "code": 0,
      "details": [
        {
          "@type": "@type"
        }
      ],
      "message": "message"
    }
  },
  "info": {
    "completedAt": "2019-12-27T18:11:19.117Z",
    "createdBy": {
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "name": "name",
        "profileId": "profileId",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      },
      "spec": {
        "type": "PROFILE_TYPE_UNSPECIFIED",
        "email": "email",
        "name": "name"
      }
    },
    "createdCount": 0,
    "deletedCount": 0,
    "failedCount": 0,
    "startedAt": "2019-12-27T18:11:19.117Z",
    "totalCount": 0,
    "unchangedCount": 0,
    "updatedCount": 0
  }
}

Returns Examples

{
  "data": {
    "bundleKey": "bundleKey",
    "agents": {
      "foo": {
        "name": "name",
        "spec": {
          "status": "AGENT_STATUS_UNSPECIFIED",
          "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED",
          "description": "description",
          "inputDataSchema": {
            "foo": "bar"
          },
          "outputDefinition": {
            "foo": "bar"
          },
          "webhookEventsUrl": "webhookEventsUrl"
        },
        "labels": {
          "foo": "string"
        },
        "schedules": {
          "foo": {
            "name": "name",
            "spec": {
              "initialMessage": "initialMessage",
              "schedule": {
                "calendars": [
                  {
                    "comment": "comment",
                    "dayOfMonth": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "dayOfWeek": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "hour": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "minute": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "month": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ],
                    "second": [
                      {
                        "end": 0,
                        "start": 0,
                        "step": 0
                      }
                    ]
                  }
                ],
                "intervals": [
                  {
                    "every": "-160513s",
                    "offset": "-160513s"
                  }
                ],
                "timezone": "timezone"
              },
              "data": {},
              "overlapPolicy": "OVERLAP_POLICY_UNSPECIFIED",
              "status": "AGENT_SCHEDULE_STATUS_UNSPECIFIED",
              "variationId": "variationId"
            },
            "labels": {
              "foo": "string"
            }
          }
        },
        "variations": {
          "foo": {
            "name": "name",
            "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
            },
            "assignments": [
              {
                "subAgentId": "subAgentId",
                "toolId": "toolId",
                "toolSetId": "toolSetId"
              }
            ],
            "labels": {
              "foo": "string"
            },
            "memoryLayers": [
              {
                "memoryLayerId": "memoryLayerId",
                "position": 0
              }
            ]
          }
        }
      }
    },
    "automaticallyPublishAgents": true,
    "memoryLayers": {
      "foo": {
        "name": "name",
        "spec": {
          "type": "MEMORY_LAYER_TYPE_UNSPECIFIED",
          "description": "description",
          "expiresAt": "2019-12-27T18:11:19.117Z",
          "systemManaged": true
        },
        "entries": {
          "foo": {
            "key": "key",
            "content": "content",
            "description": "description",
            "uploadId": "uploadId"
          }
        },
        "labels": {
          "foo": "string"
        }
      }
    },
    "sourceUrl": "sourceUrl",
    "toolSets": {
      "foo": {
        "name": "name",
        "spec": {
          "adapter": {
            "http": {
              "baseUrl": "baseUrl",
              "headers": {
                "foo": "string"
              }
            },
            "mcp": {
              "excludeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "headers": {
                "foo": "string"
              },
              "includeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "toolApprovals": {
                "always": true,
                "only": {
                  "operator": "OPERATOR_UNSPECIFIED",
                  "filters": [
                    {
                      "attribute": "ATTRIBUTE_UNSPECIFIED",
                      "matcher": {
                        "caseSensitive": true,
                        "contains": "contains",
                        "endsWith": "endsWith",
                        "exact": "exact",
                        "regex": "regex",
                        "startsWith": "startsWith"
                      }
                    }
                  ]
                }
              },
              "url": "url"
            },
            "openapi": {
              "baseUrl": "baseUrl",
              "excludeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "headers": {
                "foo": "string"
              },
              "includeTools": {
                "operator": "OPERATOR_UNSPECIFIED",
                "filters": [
                  {
                    "attribute": "ATTRIBUTE_UNSPECIFIED",
                    "matcher": {
                      "caseSensitive": true,
                      "contains": "contains",
                      "endsWith": "endsWith",
                      "exact": "exact",
                      "regex": "regex",
                      "startsWith": "startsWith"
                    }
                  }
                ]
              },
              "serverName": "serverName",
              "toolApprovals": {
                "always": true,
                "only": {
                  "operator": "OPERATOR_UNSPECIFIED",
                  "filters": [
                    {
                      "attribute": "ATTRIBUTE_UNSPECIFIED",
                      "matcher": {
                        "caseSensitive": true,
                        "contains": "contains",
                        "endsWith": "endsWith",
                        "exact": "exact",
                        "regex": "regex",
                        "startsWith": "startsWith"
                      }
                    }
                  ]
                }
              },
              "uploadId": "uploadId",
              "url": "url"
            }
          },
          "description": "description"
        },
        "labels": {
          "foo": "string"
        },
        "tools": {
          "foo": {
            "name": "name",
            "spec": {
              "config": {
                "http": {
                  "requestMethod": "HTTP_METHOD_UNSPECIFIED",
                  "headers": {
                    "foo": "string"
                  },
                  "path": "path",
                  "query": "query",
                  "requestBodyContentType": "requestBodyContentType",
                  "requestBodyTemplate": "requestBodyTemplate",
                  "toolName": "toolName"
                },
                "mcp": {
                  "toolDescription": "toolDescription",
                  "toolName": "toolName",
                  "toolTitle": "toolTitle"
                },
                "openapi": {
                  "method": "method",
                  "operationId": "operationId",
                  "path": "path"
                }
              },
              "description": "description",
              "parameters": {
                "foo": "bar"
              },
              "status": "TOOL_STATUS_UNSPECIFIED",
              "requiresApproval": true
            },
            "labels": {
              "foo": "string"
            }
          }
        }
      }
    }
  },
  "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",
    "preflightError": {
      "code": 0,
      "details": [
        {
          "@type": "@type"
        }
      ],
      "message": "message"
    }
  },
  "info": {
    "completedAt": "2019-12-27T18:11:19.117Z",
    "createdBy": {
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "name": "name",
        "profileId": "profileId",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      },
      "spec": {
        "type": "PROFILE_TYPE_UNSPECIFIED",
        "email": "email",
        "name": "name"
      }
    },
    "createdCount": 0,
    "deletedCount": 0,
    "failedCount": 0,
    "startedAt": "2019-12-27T18:11:19.117Z",
    "totalCount": 0,
    "unchangedCount": 0,
    "updatedCount": 0
  }
}