API reference

Workflow Targets

One tag: method, path, summary, auth, and scopes. Request and response fields ship in this page — expand a row to read the contract.

Browse docs

Endpoints

GET

/api/v1/workflow_targets Agent Token

List workflow targets

workflow_targets:read

Returns available workflow targets for the authenticated workspace, including targets that can reference managed secrets for outbound auth.

Agent Token

workflow_targets:read

Responses

200

List of workflow targets

Returns: WorkflowTargetList

POST

/api/v1/workflow_targets Agent Token

Create a workflow target

workflow_targets:write

Creates a new workflow target for linking traces and evals, with optional managed-secret-backed auth configuration.

Agent Token

workflow_targets:write

Request Body

Field	Type	Required	Description
name	string	Yes	Target name
metadata	object	No	Additional target metadata
environment	string	No	Environment label stored on the target
base_url	string	Yes	Absolute base URL
slug	string	No	Optional URL-safe target slug
auth_config	object	No	Optional auth configuration
auth_config.header	string	No	Header name for api_key_header auth
auth_config.secret_ref_id	string	No	Managed secret UUID for bearer or API key auth
auth_type	string (none, bearer, api_key_header)	No	Outbound auth mode
timeout_ms	integer	No	Response timeout in milliseconds for target invocation (1..120000); connection establishment is budgeted separately

Responses

201

Workflow target created

Returns: WorkflowTarget