ROroarkhq
Agent Config

Write a config revision

Changed on

Write a new revision onto a channel. Writing production creates the key when it does not exist; writing staging stages a candidate that only Roark-recognized simulation sessions will read. Every write is a new revision; nothing is overwritten.

put/v1/agent-config/{key}

Request

  • Base URL
    https://api.roark.ai
  • URL
    https://api.roark.ai/v1/agent-config/{key}
  • Auth
    HTTP bearer

Path parameters

keystring required

Request body

channel'production' | 'staging' required

Which channel to write.

documentobject required

The full config JSON for the new revision.

summarystring

One-line story of the change.

agentIdstring 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.

Example response

{
  "data": {
    "key": "support-agent"
  }
}

Changes