Autonomy and governance

Update an agent's standing

PATCH/api/w/:wid/agents/:aid/standing

Set sponsor, purpose, killOwner and assignmentEndsAt (at most 366 days ahead). The people named must be members.

#Authentication

Session cookie

A signed-in person: the console's session cookie. Every state-changing request also carries the header x-immiscible-csrf: 1, and the member's role decides what it may do. Bearer tokens are ignored on these routes, so no machine credential can reach them.

#Path parameters

widstringrequired

Workspace id

aidstringrequired

Agent id

Request

curl -X PATCH "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/agents/agt_4f2c91a7/standing" \
  -H "cookie: __Host-sid=$IMMISCIBLE_SESSION" \
  -H "x-immiscible-csrf: 1" \
  -H "content-type: application/json" \
  -d '{
    "sponsor": "cfo@acme.example",
    "purpose": "Pays approved supplier invoices",
    "killOwner": "secops@acme.example",
    "assignmentEndsAt": "2027-01-31T00:00:00Z"
  }'

const res = await fetch('https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/agents/agt_4f2c91a7/standing', {
  method: 'PATCH',
  headers: {
    cookie: `__Host-sid=${process.env.IMMISCIBLE_SESSION}`,
    'x-immiscible-csrf': '1',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    sponsor: 'cfo@acme.example',
    purpose: 'Pays approved supplier invoices',
    killOwner: 'secops@acme.example',
    assignmentEndsAt: '2027-01-31T00:00:00Z',
  }),
});
const data = await res.json();
console.log(res.status, data);

import os
import requests

res = requests.patch(
    "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/agents/agt_4f2c91a7/standing",
    headers={
        "cookie": f"__Host-sid={os.environ['IMMISCIBLE_SESSION']}",
        "x-immiscible-csrf": "1",
        "content-type": "application/json",
    },
    json={
        "sponsor": "cfo@acme.example",
        "purpose": "Pays approved supplier invoices",
        "killOwner": "secops@acme.example",
        "assignmentEndsAt": "2027-01-31T00:00:00Z",
    },
)
print(res.status_code, res.json())