Sign in
agent-personas

Launch an agent from a persona.

Changed on

Starts an agent from the persona's saved configuration with per-launch overrides layered on top. agentType runs the persona as a different agent — the model, endpoint route, and the persona's pinned provider key are then re-resolved for that type rather than carried over.

post/agent-personas/{id}/launch

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/agent-personas/{id}/launch
  • Auth: none declared. Required headers: x-organization-id

Path parameters

idstring required

Persona id (prs_*).

Headers

x-organization-idstring required

Active organization id (or slug). Required for org-scoped operations; the generated client enforces it at compile time.

Request body

promptstring required
promptStrategy'prepend-default' | 'replace'
namestring
agentTypestring
modelstring
modelEndpointIdstring
systemPromptstring
promptMode'implement' | 'plan' | 'review'
authMethod'org-key' | 'claude-max' | 'codex-subscription'
providerSecretIdstring
repoSlugstring
repoBranchstring
extraLabelIdsstring[]
groupIdstring
blueprintNamestring

Response

Response

idstring required
streamIdstring required
agentTypestring required
status'starting' | 'running' | 'needs_input' | 'completed' | 'interrupted' | 'stopping' | 'stopped' | 'error' | 'terminated' required
turnState'working' | 'idle' nullable required
turnStateVersioninteger required
devboxIdstring nullable required
tunnelKeystring nullable
namestring required
promptstring required
systemPromptstring nullable
personaIdstring nullable
modelstring nullable
blueprintIdstring nullable
blueprintNamestring nullable
promptMode'implement' | 'plan' | 'review' nullable
createdAtnumber required
lastActiveAtnumber nullable
archivedboolean required
ownerIdstring required
userIdstring nullable
prUrlstring nullable
hasBackgroundWorkboolean
listenersEnabledboolean
suspendAtTurnEndboolean
organizationIdstring required
modelProviderSecretIdstring nullable
credentialSyncPendingboolean nullable
originatorstring nullable
pinnedboolean required
mark'blocked' | 'in_review' | 'completed' nullable
viewerAccess'owner' | 'edit' | 'view'

Changes