Skip to main content
POST
Create or upsert an agent (by slug)

Authorizations

Authorization
string
header
required

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

Body

application/json
slug
string
required
Pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$
name
string
description
string
color
string
avatarSeed
string
model
string
default:claude-sonnet-4
tier
enum<string>
Available options:
platform,
byok
systemPrompt
string
tools
(string | object)[]

Tool slug (e.g. exec_command, apply_patch).

sandbox
string

Sandbox name, ID, or rt-config tag.

maxIterations
integer
maxTokens
integer
temperature
number
topP
number
topK
integer
presencePenalty
number
frequencyPenalty
number
seed
integer
stopSequences
string[]
toolChoice
Available options:
auto,
none,
required
providerOptions
object
env
object
projectId
string<uuid> | null
executionMode
enum<string>
Available options:
in_sandbox,
managed,
local-mac
targetDeviceId
string | null
defaultFolderHint
string | null
resources
object[]

Response

Updated.

data
object