Skip to main content
POST
Install an installable agent into a sandbox+workspace

Authorizations

Authorization
string
header
required

WorkOS session token or RunTools API key (rt_live_* / rt_test_*). Used in Authorization: Bearer <token> header.

Path Parameters

slug
string
required

Body

application/json
sandboxId
string
required
workspaceId
string<uuid>
required
ref
string

Branch, tag, or commit. Defaults to catalog defaultRef.

repoUrl
string

Optional public GitHub repository URL override.

displayName
string
avatarSeed
string

Response

202 - application/json

Install accepted; track via GET /installs.

data
object