api.md

Shared Params Types

• shared.ApprovalMode
• shared.ToolName
• shared.ToolSpecParam

Shared Response Types

• shared.ApprovalMode
• shared.ToolName
• shared.ToolSpec

Auth

Response Types:

• cercago.AuthContextResponse
• cercago.AuthFleetsResponse

Methods:

• client.Auth.Context(ctx context.Context) (*cercago.AuthContextResponse, error)
• client.Auth.ListFleets(ctx context.Context, query cercago.AuthListFleetsParams) (*pagination.FleetsCursorPage[cercago.Fleet], error)

OAuth

Response Types:

• cercago.OAuthConnectResponse

Methods:

• client.OAuth.Connect(ctx context.Context, provider string, body cercago.OAuthConnectParams) (*cercago.OAuthConnectResponse, error)

Connections

Params Types:

• cercago.ConnectionOwnerUnionParam
• cercago.ToolConnectionMetadataParam

Response Types:

• cercago.AttachedConnection
• cercago.Connection
• cercago.ConnectionOwner
• cercago.CredentialProvider
• cercago.CredentialType
• cercago.ToolConnectionMetadata
• cercago.ConnectionDeleteResponse
• cercago.ConnectionDetachResponse
• cercago.ConnectionListForAgentResponse

Methods:

• client.Connections.New(ctx context.Context, body cercago.ConnectionNewParams) (*cercago.Connection, error)
• client.Connections.List(ctx context.Context, query cercago.ConnectionListParams) (*pagination.ConnectionsCursorPage[cercago.Connection], error)
• client.Connections.Delete(ctx context.Context, connectionID string, body cercago.ConnectionDeleteParams) (*cercago.ConnectionDeleteResponse, error)
• client.Connections.Attach(ctx context.Context, agentID string, body cercago.ConnectionAttachParams) (*cercago.AttachedConnection, error)
• client.Connections.Detach(ctx context.Context, agentID string, connectionID string) (*cercago.ConnectionDetachResponse, error)
• client.Connections.ListForAgent(ctx context.Context, agentID string) (*cercago.ConnectionListForAgentResponse, error)

Fleets

Response Types:

• cercago.Fleet

Tools

Params Types:

• cercago.APIKeyToolSourceAuthParam
• cercago.AuthInjectionUnionParam
• cercago.HTTPEndpointParam
• cercago.HTTPToolDefinitionParam
• cercago.HTTPToolExecutionPolicyParam
• cercago.McpToolExecutionPolicyParam
• cercago.NoToolSourceAuthParam
• cercago.OAuthConnectionToolSourceAuthParam
• cercago.OAuthExchangeConfigUnionParam
• cercago.OAuthExchangeToolSourceAuthParam
• cercago.ResponseNormalizationHintParam
• cercago.ToolApprovalMode
• cercago.ToolSourceAuthUnionParam

Response Types:

• cercago.APIKeyToolSourceAuth
• cercago.AuthInjection
• cercago.HTTPEndpoint
• cercago.HTTPToolDefinition
• cercago.HTTPToolExecutionPolicy
• cercago.HTTPToolSource
• cercago.McpToolExecutionPolicy
• cercago.McpToolSource
• cercago.NoToolSourceAuth
• cercago.OAuthConnectionToolSourceAuth
• cercago.OAuthExchangeConfig
• cercago.OAuthExchangeToolSourceAuth
• cercago.ResponseNormalizationHint
• cercago.ToolApprovalMode
• cercago.ToolSource
• cercago.ToolSourceAuth

Methods:

• client.Tools.New(ctx context.Context, fleetID string, body cercago.ToolNewParams) (*cercago.ToolSource, error)
• client.Tools.Get(ctx context.Context, fleetID string, sourceID string) (*cercago.ToolSource, error)
• client.Tools.Update(ctx context.Context, fleetID string, sourceID string, body cercago.ToolUpdateParams) (*cercago.ToolSource, error)
• client.Tools.List(ctx context.Context, fleetID string, query cercago.ToolListParams) (*pagination.SourcesCursorPage[cercago.ToolSource], error)
• client.Tools.Delete(ctx context.Context, fleetID string, sourceID string) error

Webhooks

Params Types:

• cercago.WebhookSubscriptionEventType

Response Types:

• cercago.WebhookEventType
• cercago.WebhookSubscription
• cercago.WebhookSubscriptionCreated
• cercago.WebhookTestResponse

Methods:

• client.Webhooks.New(ctx context.Context, fleetID string, body cercago.WebhookNewParams) (*cercago.WebhookSubscriptionCreated, error)
• client.Webhooks.Get(ctx context.Context, fleetID string, webhookID string) (*cercago.WebhookSubscription, error)
• client.Webhooks.Update(ctx context.Context, fleetID string, webhookID string, body cercago.WebhookUpdateParams) (*cercago.WebhookSubscription, error)
• client.Webhooks.List(ctx context.Context, fleetID string, query cercago.WebhookListParams) (*pagination.SubscriptionsCursorPage[cercago.WebhookSubscription], error)
• client.Webhooks.Delete(ctx context.Context, fleetID string, webhookID string) error
• client.Webhooks.Rotate(ctx context.Context, fleetID string, webhookID string) (*cercago.WebhookSubscriptionCreated, error)
• client.Webhooks.Test(ctx context.Context, fleetID string, webhookID string) (*cercago.WebhookTestResponse, error)

Events

Response Types:

• cercago.RuntimeWebhookEvent
• cercago.SubscriptionEvent
• cercago.ThreadStreamEvent

Methods:

• client.Events.ListForAgent(ctx context.Context, agentID string, query cercago.EventListForAgentParams) (*pagination.EventsCursorPage[cercago.SubscriptionEvent], error)
• client.Events.ListForFleet(ctx context.Context, fleetID string, query cercago.EventListForFleetParams) (*pagination.EventsCursorPage[cercago.SubscriptionEvent], error)
• client.Events.ListForThread(ctx context.Context, agentID string, threadID string, query cercago.EventListForThreadParams) (*pagination.EventsCursorPage[cercago.SubscriptionEvent], error)
• client.Events.StreamForAgent(ctx context.Context, agentID string, params cercago.EventStreamForAgentParams) (*cercago.SubscriptionEvent, error)
• client.Events.StreamForFleet(ctx context.Context, fleetID string, params cercago.EventStreamForFleetParams) (*cercago.SubscriptionEvent, error)
• client.Events.StreamForThread(ctx context.Context, agentID string, threadID string) (*cercago.ThreadStreamEvent, error)
• client.Events.StreamForThreadEvents(ctx context.Context, agentID string, threadID string, params cercago.EventStreamForThreadEventsParams) (*cercago.SubscriptionEvent, error)

Agents

Params Types:

• cercago.ApprovalPolicyParam
• cercago.ConfigurationParam
• cercago.MetadataParam

Response Types:

• cercago.Agent
• cercago.AgentSummary
• cercago.ApprovalPolicy
• cercago.Configuration
• cercago.ConfigurationFieldName
• cercago.DiscoveredTool
• cercago.EffectiveConfiguration
• cercago.ExecutionPrincipal
• cercago.Metadata
• cercago.SourceWarning
• cercago.Tool
• cercago.ToolDescriptor
• cercago.AgentDeleteResponse
• cercago.AgentListToolsResponse

Methods:

• client.Agents.New(ctx context.Context, body cercago.AgentNewParams) (*cercago.Agent, error)
• client.Agents.Get(ctx context.Context, agentID string) (*cercago.Agent, error)
• client.Agents.Update(ctx context.Context, agentID string, body cercago.AgentUpdateParams) (*cercago.Agent, error)
• client.Agents.List(ctx context.Context, query cercago.AgentListParams) (*pagination.AgentsCursorPage[cercago.AgentSummary], error)
• client.Agents.Delete(ctx context.Context, agentID string) (*cercago.AgentDeleteResponse, error)
• client.Agents.ListTools(ctx context.Context, agentID string) (*cercago.AgentListToolsResponse, error)
• client.Agents.GetConfig(ctx context.Context, agentID string) (*cercago.EffectiveConfiguration, error)
• client.Agents.UpdateMetadata(ctx context.Context, agentID string, body cercago.AgentUpdateMetadataParams) (*cercago.Agent, error)

Threads

Params Types:

• cercago.Status

Response Types:

• cercago.ActivityDetail
• cercago.ActivitySummary
• cercago.CompiledContext
• cercago.ContentBlock
• cercago.Message
• cercago.MessagePage
• cercago.Status
• cercago.SteerResult
• cercago.SubThreadSummary
• cercago.Thread
• cercago.ThreadSummary
• cercago.ThreadTurnSummary
• cercago.TokenUsage
• cercago.Turn

Methods:

• client.Threads.New(ctx context.Context, agentID string, body cercago.ThreadNewParams) (*cercago.Thread, error)
• client.Threads.Get(ctx context.Context, agentID string, threadID string, query cercago.ThreadGetParams) (*cercago.Thread, error)
• client.Threads.List(ctx context.Context, agentID string, query cercago.ThreadListParams) (*pagination.ThreadsCursorPage[cercago.ThreadSummary], error)
• client.Threads.Activity(ctx context.Context, agentID string, threadID string, query cercago.ThreadActivityParams) (*cercago.ActivityDetail, error)
• client.Threads.Cancel(ctx context.Context, agentID string, threadID string) (*cercago.Thread, error)
• client.Threads.Close(ctx context.Context, agentID string, threadID string) (*cercago.Thread, error)
• client.Threads.Compact(ctx context.Context, agentID string, threadID string) (*cercago.Thread, error)
• client.Threads.ListMessages(ctx context.Context, agentID string, threadID string, query cercago.ThreadListMessagesParams) (*pagination.ThreadMessagesCursorPage[cercago.Message], error)
• client.Threads.StartTurn(ctx context.Context, agentID string, threadID string, body cercago.ThreadStartTurnParams) (*cercago.Turn, error)
• client.Threads.Steer(ctx context.Context, agentID string, threadID string, body cercago.ThreadSteerParams) (*cercago.SteerResult, error)

Context

Response Types:

• cercago.Entry
• cercago.EntrySummary
• cercago.SearchResult
• cercago.ContextDeleteResponse

Methods:

• client.Context.Get(ctx context.Context, agentID string, query cercago.ContextGetParams) (*cercago.Entry, error)
• client.Context.List(ctx context.Context, agentID string, query cercago.ContextListParams) (*pagination.EntriesCursorPage[cercago.EntrySummary], error)
• client.Context.Delete(ctx context.Context, agentID string, body cercago.ContextDeleteParams) (*cercago.ContextDeleteResponse, error)
• client.Context.Search(ctx context.Context, agentID string, query cercago.ContextSearchParams) (*pagination.ResultsCursorPage[cercago.SearchResult], error)
• client.Context.Write(ctx context.Context, agentID string, body cercago.ContextWriteParams) (*cercago.Entry, error)

Schedules

Response Types:

• cercago.Schedule
• cercago.ScheduleListResponse
• cercago.ScheduleDeleteResponse
• cercago.ScheduleTriggerResponse

Methods:

• client.Schedules.New(ctx context.Context, agentID string, body cercago.ScheduleNewParams) (*cercago.Schedule, error)
• client.Schedules.Update(ctx context.Context, agentID string, scheduleID string, body cercago.ScheduleUpdateParams) (*cercago.Schedule, error)
• client.Schedules.List(ctx context.Context, agentID string) (*cercago.ScheduleListResponse, error)
• client.Schedules.Delete(ctx context.Context, agentID string, scheduleID string) (*cercago.ScheduleDeleteResponse, error)
• client.Schedules.Trigger(ctx context.Context, agentID string, scheduleID string) (*cercago.ScheduleTriggerResponse, error)

ApprovalRequests

Response Types:

• cercago.ApprovalRequest

Methods:

• client.ApprovalRequests.List(ctx context.Context, agentID string, query cercago.ApprovalRequestListParams) (*pagination.ApprovalRequestsCursorPage[cercago.ApprovalRequest], error)
• client.ApprovalRequests.Resolve(ctx context.Context, agentID string, threadID string, approvalID string, body cercago.ApprovalRequestResolveParams) (*cercago.ApprovalRequest, error)

ApprovalGrants

Response Types:

• cercago.ApprovalGrant
• cercago.ApprovalGrantDeleteResponse
• cercago.ApprovalGrantDeleteForThreadResponse

Methods:

• client.ApprovalGrants.List(ctx context.Context, agentID string, query cercago.ApprovalGrantListParams) (*pagination.GrantsCursorPage[cercago.ApprovalGrant], error)
• client.ApprovalGrants.Delete(ctx context.Context, agentID string, grantID string) (*cercago.ApprovalGrantDeleteResponse, error)
• client.ApprovalGrants.DeleteForThread(ctx context.Context, agentID string, threadID string, grantID string) (*cercago.ApprovalGrantDeleteForThreadResponse, error)
• client.ApprovalGrants.ListForThread(ctx context.Context, agentID string, threadID string) (*[]cercago.ApprovalGrant, error)

Sandbox

Response Types:

• cercago.ExecResult
• cercago.ReadResponse
• cercago.SandboxWriteResponse

Methods:

• client.Sandbox.Exec(ctx context.Context, agentID string, body cercago.SandboxExecParams) (*cercago.ExecResult, error)
• client.Sandbox.Read(ctx context.Context, agentID string, body cercago.SandboxReadParams) (*cercago.ReadResponse, error)
• client.Sandbox.Write(ctx context.Context, agentID string, body cercago.SandboxWriteParams) (*cercago.SandboxWriteResponse, error)

Models

Response Types:

• cercago.ModelDescriptor
• cercago.ModelListResponse

Methods:

• client.Models.List(ctx context.Context) (*cercago.ModelListResponse, error)