Docs/API Reference

API Reference

The PermitNetworks REST API. All endpoints require authentication via API key in the Authorization header.

Base URL: https://api.permitnetworks.com
POST/v1/authorize

Submit an authorization request for evaluation. Returns an allow or deny decision with the applied policy trace, latency metrics, and a signed decision token.

Parameters

agent_idstringThe agent requesting authorization
actionstringThe action to authorize (e.g., "spend", "read", "execute")
resourcestringThe target resource identifier
contextobjectAdditional context for policy evaluation
GET/v1/decisions

Query historical authorization decisions with filtering by agent, action, outcome, and time range. Supports pagination and full-text search on decision metadata.

Parameters

agent_idstringFilter by agent identifier
outcomestringFilter by "allow" or "deny"
fromISO 8601Start of time range
limitintegerResults per page (default: 50, max: 1000)
POST/v1/policies

Create or update an authorization policy. Policies are versioned and can be rolled back. Supports allow/deny rules, budget constraints, rate limits, and scope definitions.

Parameters

namestringHuman-readable policy name
rulesarrayArray of policy rules with conditions and effects
priorityintegerEvaluation order priority (lower = first)
GET/v1/agents

List all registered agents with their current status, assigned policies, spending totals, and decision statistics. Supports filtering by tag and status.

Parameters

statusstringFilter by "active", "suspended", or "all"
tagstringFilter by agent tag

Authentication

All API requests require an API key passed in the Authorization header. API keys are scoped per environment (development, staging, production) and can be created in the dashboard.

Authorization: Bearer pn_live_sk_...