Update agent guidance

Edit a guidance pack — bumps version and snapshots the revision. Sessions dispatched afterwards pick up the new version; existing sessions keep the refs they recorded.

PATCH/workspaces/{organizationId}/agent/guidance/{id}

Path parameters

organizationIdstringrequired

idstringrequired

Request body

application/json

namestring

min length 1

scopestring

Allowed:workspaceteamstatusstep

scopeKeystring | null

min length 1

bodystring

min length 1

linksobject[] | null

Show properties

Array of object

labelstring

urlstringrequired

Responses

200

Guidance pack updated

idstringrequired

organizationIdstringrequired

namestringrequired

scopestringrequired

Allowed:workspaceteamstatusstep

scopeKeystring | nullrequired

bodystringrequired

linksobject[] | nullrequired

Show properties

Array of object

labelstring

urlstringrequired

versionintegerrequired

createdBystring | nullrequired

updatedBystring | nullrequired

createdAtstringrequired

updatedAtstringrequired

404

Guidance pack not found

Try it

Server

Custom base URLOverrides the selected server when set.

Parameters

organizationIdpath*idpath*

Bodyapplication/json

Request body

Request

curl -X PATCH '/workspaces/string/agent/guidance/string' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "scope": "workspace",
  "scopeKey": "string",
  "body": "string",
  "links": [
    {
      "label": "string",
      "url": "string"
    }
  ]
}'

const response = await fetch("/workspaces/string/agent/guidance/string", {
  method: "PATCH",
  headers: {
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"scope\": \"workspace\",\n  \"scopeKey\": \"string\",\n  \"body\": \"string\",\n  \"links\": [\n    {\n      \"label\": \"string\",\n      \"url\": \"string\"\n    }\n  ]\n}"
});

import requests

response = requests.patch(
    "/workspaces/string/agent/guidance/string",
    headers={
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"scope\": \"workspace\",\n  \"scopeKey\": \"string\",\n  \"body\": \"string\",\n  \"links\": [\n    {\n      \"label\": \"string\",\n      \"url\": \"string\"\n    }\n  ]\n}",
)

Response

{
  "id": "string",
  "organizationId": "string",
  "name": "string",
  "scope": "workspace",
  "scopeKey": "string",
  "body": "string",
  "links": [
    {
      "label": "string",
      "url": "string"
    }
  ],
  "version": 0,
  "createdBy": "string",
  "updatedBy": "string",
  "createdAt": "string",
  "updatedAt": "string"
}