Skip to content

Sets the inline-enforcement posture for a guardrail class.

PUT
/v1/m/security/enforcement
curl --request PUT \
--url https://example.com/v1/m/security/enforcement \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "class": "example", "enabled": true, "min_severity": "example", "reason": "example" }'

Sets the inline-enforcement posture for a guardrail class. This is the ONLY production-affecting action in the module, so it is admin-tier AND governed by the ApprovalGate where wired: enabling enforcement asks the ApprovalGate, and the result records whether it was governed.

X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Media type application/json
object
class
required

After trimming, must be non-empty; ’*’ selects all guardrail classes.

string
enabled
Any of:

Omitted or null decodes as false, returning the class to detective mode.

boolean
min_severity
Any of:

After trimming, empty defaults to high; otherwise must be low, medium, high or critical.

string
reason
Any of:

Trimmed and byte-capped before an enablement approval request.

string
Example generated
{
"class": "example",
"enabled": true,
"min_severity": "example",
"reason": "example"
}

OK

Media type application/json
object
Example generated
{}

Bad request

Media type application/json
object
Example generated
{}

Unauthenticated

Media type application/json
object
Example generated
{}

Forbidden

Media type application/json
object
Example generated
{}

Not found

Media type application/json
object
Example generated
{}

Conflict / setup required

Media type application/json
object
Example generated
{}

Rate limited

Media type application/json
object
Example generated
{}