Skip to content
sgp
API Reference

Agent Configs

Create Agent Config
agent_configs.create(AgentConfigCreateParams**kwargs) -> AgentConfigCreateResponse
POST/v5/agent_configs
List Agent Configs
agent_configs.list(AgentConfigListParams**kwargs) -> SyncCursorPage[AgentConfigListResponse]
GET/v5/agent_configs
List MCP Tool Names
agent_configs.list_mcp_tools() -> AgentConfigListMcpToolsResponse
GET/v5/agent_configs/mcp_tools
Get Agent Config
agent_configs.retrieve(stragent_config_id) -> AgentConfigRetrieveResponse
GET/v5/agent_configs/{agent_config_id}
Update Agent Config
agent_configs.update(stragent_config_id, AgentConfigUpdateParams**kwargs) -> AgentConfigUpdateResponse
PATCH/v5/agent_configs/{agent_config_id}
Delete Agent Config (hard delete)
agent_configs.delete(stragent_config_id) -> AgentConfigDeleteResponse
DELETE/v5/agent_configs/{agent_config_id}
ModelsExpand Collapse
class RepoSpec: …

A single repo the agent should clone into its workspace.

Mirrors the per-entry shape the golden agent’s _validate_repos accepts: url is required, the rest are optional passthrough hints. Sent verbatim as task.params.repos so provisioning clones these instead of the deployment-global default.

url: str
maxLength2048
minLength1
depth: Optional[int]
minimum1
path: Optional[str]
maxLength1024
class AgentConfigCreateResponse: …
id: str
allowed_tools: List[str]
created_at: datetime
formatdate-time
harness: str
model: str
name: str
system_prompt: str
updated_at: datetime
formatdate-time
description: Optional[str]
object: Optional[Literal["agent_config"]]
persistent_workspace: Optional[bool]
repos: Optional[List[RepoSpec]]
url: str
maxLength2048
minLength1
depth: Optional[int]
minimum1
path: Optional[str]
maxLength1024
class AgentConfigListResponse: …
id: str
allowed_tools: List[str]
created_at: datetime
formatdate-time
harness: str
model: str
name: str
system_prompt: str
updated_at: datetime
formatdate-time
description: Optional[str]
object: Optional[Literal["agent_config"]]
persistent_workspace: Optional[bool]
repos: Optional[List[RepoSpec]]
url: str
maxLength2048
minLength1
depth: Optional[int]
minimum1
path: Optional[str]
maxLength1024
List[Literal["Slack", "Linear", "GitHub", 21 more]]
One of the following:
"Slack"
"Linear"
"GitHub"
"Confluence"
"Notion"
"Datadog"
"PagerDuty"
"Salesforce"
"Figma"
"Granola"
"Jira"
"Gmail"
"GoogleCalendar"
"GoogleDrive"
"GoogleDocs"
"GoogleSheets"
"GoogleSlides"
"Snowflake"
"Redash"
"Tableau"
"Metabase"
"Gong"
"ZoomInfo"
"Clay"
class AgentConfigRetrieveResponse: …
id: str
allowed_tools: List[str]
created_at: datetime
formatdate-time
harness: str
model: str
name: str
system_prompt: str
updated_at: datetime
formatdate-time
description: Optional[str]
object: Optional[Literal["agent_config"]]
persistent_workspace: Optional[bool]
repos: Optional[List[RepoSpec]]
url: str
maxLength2048
minLength1
depth: Optional[int]
minimum1
path: Optional[str]
maxLength1024
class AgentConfigUpdateResponse: …
id: str
allowed_tools: List[str]
created_at: datetime
formatdate-time
harness: str
model: str
name: str
system_prompt: str
updated_at: datetime
formatdate-time
description: Optional[str]
object: Optional[Literal["agent_config"]]
persistent_workspace: Optional[bool]
repos: Optional[List[RepoSpec]]
url: str
maxLength2048
minLength1
depth: Optional[int]
minimum1
path: Optional[str]
maxLength1024
class AgentConfigDeleteResponse: …
id: str
deleted: bool
object: Optional[Literal["agent_config"]]