Upsert AI router instruction

Write a new routing-instruction version for a project. Versions are append-only; the latest one is the active instruction.

PUT /api/v1/org/aiRouter/instructions/{projectUuid}

Error

A valid request URL is required to generate request examples

200

{
  "results": {
    "createdAt": "2023-11-07T05:31:56Z",
    "taggedAgentUuids": [
      "<string>"
    ],
    "instruction": "<string>",
    "projectUuid": "<string>",
    "routerUuid": "<string>",
    "instructionVersionUuid": "<string>"
  },
  "status": "ok"
}

{
  "error": {
    "name": "<string>",
    "statusCode": 123,
    "data": "<unknown>",
    "message": "<string>"
  },
  "status": "error"
}

Path Parameters

projectUuid · string · required

Body

application/json

taggedAgentUuids · string[] · required

instruction · string · required

Response

200

application/json

Success

results · object | null · required

Per-project routing instructions written by an admin. Versioned append-only (like agent instructions): the latest version for a (router, project) pair is the active one. instruction is free text where tagged agents are embedded as @[Agent Name](agent-uuid) tokens; taggedAgentUuids is the extracted list, kept alongside the text so references can be validated and orphans detected.

Show child attributes

status · enum<string> · required

Available options: ok