Skip to main content
PUT
JavaScript

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

key
string
required
Required string length: 1 - 120
Pattern: ^[A-Za-z0-9][A-Za-z0-9_.-]*$

Body

application/json
channel
enum<string>
required

Which channel to write.

Available options:
production,
staging
document
object
required

The full config JSON for the new revision.

summary
string

One-line story of the change.

Maximum string length: 500
agentId
string<uuid>

Link this config to a Roark agent (the one your calls report). Required before Autoimprove can run on it: the link is how a fix finds the config channel.

Response

The config with its updated channel pointers.

data
object
required

A managed config for a code-first agent (LiveKit, Pipecat, or any stack using the SDK): your agent fetches its tunable surface from Roark at session start. Two channels: production for real traffic, staging for candidates under test.