List policy presets

GET/api/public/v1/policy-presets

Every preset in scope (builtin, organization, both when absent): organization presets by name, then built-in presets, each with its title, one-line description and rules. A built-in preset is read-only; an organization preset carries its creator and revision. Choose rules with POST /aip/drafts and preset.

curl --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/policy-presets?scope=builtin' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY"

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/policy-presets?scope=builtin',
    method='GET',
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
    },
)
with urllib.request.urlopen(request) as response:
    text = response.read().decode()
    print(json.dumps(json.loads(text), indent=2) if text else response.status)

#!/usr/bin/env bash
set -euo pipefail

curl -sS --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/policy-presets?scope=builtin' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" | jq .

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
Invoke-RestMethod -Method GET -Uri 'https://app.openlatch.ai/api/public/v1/policy-presets?scope=builtin' -Headers $headers | ConvertTo-Json -Depth 20

Authorization

Role in the organization	This endpoint
`owner`	Allowed
`admin`	Allowed
`editor`	Allowed
`viewer`	Allowed

A key carries the role its owner holds in the organization. See Authentication.

API key scope: presets:read

Query parameters

Parameter	Type	Description
`scope`	string or null

Response

200 OK — the call succeeded.
401 Unauthorized — UNAUTHORIZED
402 Payment Required — license_expired
403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
422 Unprocessable Content — INVALID_ID, VALIDATION_ERROR
429 Too Many Requests — TOO_MANY_REQUESTS
500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
503 Service Unavailable — FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Response fields

Field	Type	Description
`data`	object	Required.
`data.presets`	array of object	Required.
`data.presets[].created_by`	object or null
`data.presets[].default_selected`	boolean	Required. False for a framework preset, otherwise true.
`data.presets[].description`	string	Required.
`data.presets[].framework`	object or null	Required. Set on a framework preset; null on every other.
`data.presets[].key`	string	Required.
`data.presets[].kind`	string — one of builtin, organization	Required.
`data.presets[].revision`	object or null
`data.presets[].rules`	array of object	Required.
`data.presets[].title`	string	Required.

Example response

{
  "data": {
    "presets": [
      {
        "created_by": {
          "name": "release-bot"
        },
        "default_selected": false,
        "description": "string",
        "framework": {
          "notice": "string",
          "source": {}
        },
        "key": "string",
        "kind": "builtin",
        "revision": 3,
        "rules": [
          {
            "capability": "enforce",
            "citation": {},
            "dimension": "quality",
            "intent_key": "string",
            "sentence": "string"
          }
        ],
        "title": "string"
      }
    ]
  }
}