Skip to navigation

Save a policy

Saves a named policy for the key; its overrides must be patterns.

Authentication

AuthorizationBearer

An API key: Authorization: Bearer bl_live_….

OR
AuthorizationBearer

Blende’s apps: a sign-in JWT, sent with Blende-Context-Key.

Headers

Idempotency-KeystringOptional<=255 characters

A unique key per call; a retry with it answers the first result.

Request

This endpoint expects an object.
namestringRequired
The caller's own label.
policyobjectRequired

The policy; its overrides must be patterns.

Response headers

Cache-ControlenumOptional

Always no-store.

Allowed values:
Request-IdstringOptional
The request's id.
RateLimitstringOptional
The quota left in the current window.
RateLimit-PolicystringOptional

The rate-limit policy in force.

Response

The saved policy, every field filled in.
idenum or string

A built-in’s name or a saved policy’s pol_… id.

namestring

Your label; a built-in’s is its id.

policyobject
Every field filled in.
created_atdatetime or null

RFC 3339; null for a built-in.

updated_atdatetime or null

RFC 3339; null for a built-in.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
415
Unsupported Media Type Error
429
Too Many Requests Error
500
Internal Server Error