Skip to content

API endpoints

This page lists every endpoint your services can call. For the full request and response details of each one, see the App-token API reference.

Everything else, such as managing your organization, members, and app tokens, is done in the Console.

All endpoints are under the versioned base path https://api.zstrike.io/api/v2026-01/, require the x-op-id and x-session-id headers, and use the standard response envelope.

Authenticate with an app token as Authorization: Bearer <token>. The Permission column shows the grant each endpoint needs. A project-scoped token can act only on its own project.

Method Path Permission Description
GET /projects projects: read List the projects in the token’s scope
POST /projects projects: write Create a project
PATCH /projects/:projectId/attributes projects: write Update project details
Method Path Permission Description
GET /projects/:projectId/schema?version= schema: read Read the Cedar schema (current or a version)
PUT /projects/:projectId/schema schema: write Update the schema
Method Path Permission Description
GET /projects/:projectId/policies policies: read List policies (?inactive= to include inactive)
GET /projects/:projectId/policyList policies: read Paginated policy list (page, limit, search, status, sortBy=updatedAt|description, sortDir, metadataEquals[<path>]=); returns meta with page, limit, total
GET /projects/:projectId/policy?policyId=&version= policies: read Read a policy version
POST / PUT /projects/:projectId/policy policies: write Create / update a policy
DELETE /projects/:projectId/policy policies: delete Delete a policy
POST /projects/:projectId/policy/analyze policies: write Impact analysis of a candidate policy (policy, policyId?); saves nothing

Org-scoped tokens pass projectId in the request body of the bulk endpoints (batch, validate, reconcile).

Method Path Permission Description
GET /projects/:projectId/entities entities: read List entities
GET /projects/:projectId/entityList entities: read Paginated entity list
GET /projects/:projectId/entity?uid=&version= entities: read Read an entity version
GET /projects/:projectId/search-entities entities: read Search (?query=&type=&status=)
POST / PUT /projects/:projectId/entity entities: write Create / update one entity
DELETE /projects/:projectId/entity entities: delete Delete one entity
POST /projects/entities/batch entities: write (+ delete for deletes) Bulk operations, up to 250 per request (guide)
POST /projects/entities/validate entities: write Validate entities against the active schema
POST /projects/entities/reconcile entities: write + delete Declarative full-state sync (guide)
Method Path Permission Description
GET /projects/:projectId/sessions projects: read List the sessions seen in the project’s audit history
GET /projects/:projectId/sessions/:sessionId/activity projects: read Read the audit activity of one session
POST /projects/:projectId/sessions/:sessionId/reset projects: write Reset a session, which clears the PDP’s counters for it
Method Path Permission Description
POST /pdp/shared?projectId=&region= projects: write Attach a project to a shared PDP
GET /pdp/shared projects: read Read the attachment and client token status
Method Path Permission Description
GET /audit/events audit: read Query decisions (projectId, principal, action, resource, decision, policy, start_date, end_date, pageSize ≤ 100, offset, sortBy, sortOrder)
GET /audit/summary audit: read Aggregate counts for the same filters: totals, byPrincipal, byAction, byPolicy, lastActivityAt

The PDP’s data-plane API, called by your applications with the project’s client token (guide):

Method Path Description
POST /authorize Evaluate one authorization request → Allow / Deny + diagnostics
POST /permissions Bulk permissions: which actions a principal may take on a resource (no audit events)
GET /health 200 when serving, 503 while starting