Skip to main content
GET
List MAIP Policies

List MAIP Policies

GET /v1/maip/policies Returns all MAIP agent policies configured for the authenticated tenant. Policies define runtime enforcement rules that govern what agents can do based on trust scores, scopes, delegation depth, and agent type.

Authentication

Requires X-API-Key header or Bearer JWT token. Tenant-scoped via cookie or JWT claim.

Response

Returns an array of policy objects.
string
UUID primary key of the policy.
string
UUID of the owning tenant.
string
Human-readable policy name. Used in denial messages and audit logs.
string
Detailed description of what the policy enforces.
string
Policy category. One of: "scope", "trust", "rate", "custom".
string
Policy lifecycle status. One of: "active", "disabled", "archived". Only active policies are evaluated during policy checks.
integer
Evaluation priority. Lower numbers are evaluated first. Default: 100.
object
JSON array of policy rules. Each rule contains conditions, an effect ("allow", "deny", "require_approval"), and an optional requires_approval flag. See Create Policy for the full rule schema.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-updated timestamp.

Example

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Response

Array of policies

id
string<uuid>

UUID primary key

tenant_id
string<uuid>

UUID of the owning tenant

name
string

Human-readable policy name

description
string

Detailed policy description

category
enum<string>

Policy category

Available options:
scope,
trust,
rate,
custom
status
enum<string>

Policy lifecycle status

Available options:
active,
disabled,
archived
priority
integer

Evaluation priority (lower = first)

rules
object[]

Array of policy rules

created_at
string<date-time>
updated_at
string<date-time>