Create or replace one pipeline spend policy row

Writes the policy row for scope.

Every axis is optional, and null clears that axis, letting it fall
through to the next resolution tier (and to unlimited if no tier sets
it). An explicitly stored 0 is a real cap meaning "block everything",
which is distinct from null. The write replaces the whole row, so an
omitted axis is cleared rather than preserved.

perRunCostUsd is rejected on the node scope: a per-run ceiling is a
property of a single run, not a node-wide aggregate, so accepting it
there would store a value that never applies.

Permissions: Node owner or workspace administrator — for every
scope, including a user's own. A user raising their own cap would defeat
the purpose of having one.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The UUID of the compute node

string
required

node (node-wide cap across all users), default (per-user
default), a Pennsieve user node id, or the literal me.

Body Params
number | null

Spend cap for the UTC day. Null clears the axis.

number | null

Spend cap for the UTC month. Null clears the axis.

number | null

Ceiling on one run's total cost. Not valid on the node scope.

integer | null

Bound on simultaneous non-terminal runs. Run cost is only
known at finalize, so concurrent runs are invisible to a
pre-flight spend check; this is what bounds the resulting
overrun.

string
Responses

400

Invalid body, missing scope, or perRunCostUsd set on the node scope.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json