Machine admin

Create a service token

POST/api/w/:wid/service-tokens

Owners. The token is in the answer once. See service tokens.

Field	Description
`name`	after what will hold it, for example “Splunk SOAR”
`scopes`	from `agents:read`, `agents:write`, `agents:freeze`, `approvals:read`, `evidence:read`
`expiresInDays`	1 to 90; every token expires
`ipAllow`	optional: up to 20 addresses or CIDR ranges

#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

Request

curl -X POST "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/service-tokens" \
  -H "cookie: __Host-sid=$IMMISCIBLE_SESSION" \
  -H "x-immiscible-csrf: 1" \
  -H "content-type: application/json" \
  -d '{
    "name": "Splunk SOAR",
    "scopes": [
      "agents:read",
      "agents:freeze"
    ],
    "expiresInDays": 90,
    "ipAllow": [
      "203.0.113.0/24"
    ]
  }'

const res = await fetch('https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/service-tokens', {
  method: 'POST',
  headers: {
    cookie: `__Host-sid=${process.env.IMMISCIBLE_SESSION}`,
    'x-immiscible-csrf': '1',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Splunk SOAR',
    scopes: ['agents:read', 'agents:freeze'],
    expiresInDays: 90,
    ipAllow: ['203.0.113.0/24'],
  }),
});
const data = await res.json();
console.log(res.status, data);

import os
import requests

res = requests.post(
    "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/service-tokens",
    headers={
        "cookie": f"__Host-sid={os.environ['IMMISCIBLE_SESSION']}",
        "x-immiscible-csrf": "1",
        "content-type": "application/json",
    },
    json={
        "name": "Splunk SOAR",
        "scopes": ["agents:read", "agents:freeze"],
        "expiresInDays": 90,
        "ipAllow": ["203.0.113.0/24"],
    },
)
print(res.status_code, res.json())

Response

JSON

{ "id": "stk_2f9b", "name": "Splunk SOAR", "scopes": ["agents:read", "agents:freeze"], "expiresAt": "2027-01-02T09:00:00Z", "token": "ims_...", "note": "This is the only time the token is shown." }