Skip to main content
POST
Roll out block version

Authorizations

Authorization
string
header
required

Organization API key, generated in studio.sidenet.ai. Backend only — never in a browser.

Path Parameters

id
string
required
Example:

"d41a8f6b-9c27-4b13-a5e8-2f60c1d7b394"

Body

application/json
agentIds
string[]

Limit the rollout to these agents. Omit to roll out to every one.

Example:
activate
boolean
default:true

Response

What happened to each agent. A partial rollout is still a 200 — read all three lists.

rolledOut
object[]

Agents republished onto the current block version.

skipped
object[]

Agents deliberately left alone — already current, or carrying unpublished draft edits that a rollout must not ship.

failed
object[]

Agents whose publish or activate failed.