Guardrails

List a guardrail's config versions

Returns the guardrail's archived configurations, newest first. A version is written on create and on every subsequent write that changes the policy document — through the REST API or a formation apply alike. Metadata-only edits (name, description, context binding) do not archive a version. See Versioning.

get/v1/projects/{project_id}/guardrails/{guardrail_id}/versions

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/guardrails/{guardrail_id}/versions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

guardrail_idstring required

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

Response

List of guardrail versions, newest first

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "id": "guard_ver_V1StGXR8Z5jdHi6B",
      "guardrail_id": "guard_V1StGXR8Z5jdHi6B",
      "version": 1,
      "label": "restored from v2",
      "created_by_principal_type": "user",
      "created_by_principal_id": "user_V1StGXR8Z5jdHi6B"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.