# Praxa

## Docs

- [Authenticating Praxa API Requests with OAuth Bearer Tokens](https://docs.praxa.io/api-reference/authentication.md): The Praxa API uses short-lived OAuth 2.0 Bearer tokens. Send your token in the Authorization header on every request. Each token covers one or more scopes.
- [POST /v8/capabilities/search — Search Available Capabilities](https://docs.praxa.io/api-reference/capabilities/search.md): POST /v8/capabilities/search returns capabilities matching your requirement string. Discover available gateway actions before committing to a mission.
- [GET /v8/context-twin/goals — List Active Context Goals](https://docs.praxa.io/api-reference/context/goals.md): GET /v8/context-twin/goals returns the current goal list from the context twin associated with your deployment. Requires context:read scope.
- [GET /v8/coverage — Get Integration Gateway Coverage](https://docs.praxa.io/api-reference/coverage.md): GET /v8/coverage returns a reference coverage report showing which Praxa API endpoints and capabilities are available on your gateway deployment.
- [Praxa API Error Codes, Status Codes, and Problem Details](https://docs.praxa.io/api-reference/errors.md): Praxa API errors use RFC 9457 problem+json format. Learn what each HTTP status code means, how to read the problem detail, and how to recover from errors.
- [POST /v8/memory/query — Query Persistent Mission Memory](https://docs.praxa.io/api-reference/memory/query.md): POST /v8/memory/query retrieves relevant entries from persistent mission memory using a natural language query. Requires memory:read scope.
- [POST /v8/missions/{runId}/cancel — Cancel a Mission](https://docs.praxa.io/api-reference/missions/cancel.md): POST /v8/missions/{runId}/cancel requests cancellation of a running Praxa mission. The status transitions to cancelled after the current step finishes.
- [POST /v8/missions — Create a Governed Agent Mission](https://docs.praxa.io/api-reference/missions/create.md): POST /v8/missions creates a governed AI agent mission. Accepts a goal specification and resource budget. Requires missions:write scope and Idempotency-Key.
- [GET /v8/missions/{runId}/events — Stream Mission Events](https://docs.praxa.io/api-reference/missions/events.md): GET /v8/missions/{runId}/events streams Server-Sent Events for a Praxa mission. The stream closes automatically when the mission reaches a terminal state.
- [GET /v8/missions/{runId} — Retrieve Mission Status](https://docs.praxa.io/api-reference/missions/get.md): GET /v8/missions/{runId} fetches the current status and step history of a Praxa mission by its run ID. Requires missions:read scope.
- [POST /v8/missions/{runId}/signals — Send a Mission Signal](https://docs.praxa.io/api-reference/missions/signal.md): POST /v8/missions/{runId}/signals sends a named signal with a JSON payload to a Praxa mission, enabling mid-flight user input or workflow injection.
- [Praxa Integration Gateway REST API v8.1.0 Reference](https://docs.praxa.io/api-reference/overview.md): The Praxa Integration Gateway REST API v8.1.0 lets you submit and manage governed AI agent missions. All 14 endpoints require scoped OAuth Bearer tokens.
- [GET /v8/skills/{skillId} — Retrieve a Skill Definition](https://docs.praxa.io/api-reference/skills/get.md): GET /v8/skills/{skillId} returns the definition and metadata for a specific skill available in the Praxa Integration Gateway. Requires skills:read scope.
- [GET /v8/traces/{traceId} — Inspect Mission Execution Trace](https://docs.praxa.io/api-reference/traces/get.md): GET /v8/traces/{traceId} retrieves a detailed execution trace for a completed Praxa mission step, including timing, inputs, outputs, and tool calls made.
- [GET /v8/world-model/certificates — List World Certificates](https://docs.praxa.io/api-reference/world-model/certificates.md): GET /v8/world-model/certificates returns certified facts from the world model associated with your Praxa deployment. Requires world:read scope.
- [Authenticate with the Praxa Integration Gateway API](https://docs.praxa.io/authentication.md): Praxa uses short-lived OAuth Bearer tokens scoped per operation. Learn how to acquire a token, pass it to the SDK or CLI, and handle auth errors.
- [Praxa Benchmarks: Measuring Agentic Mission Performance](https://docs.praxa.io/benchmarks/overview.md): The Praxa benchmarks suite measures mission latency, event streaming throughput, SDK retry performance, and gateway reliability under load.
- [Praxa SDK Performance Characteristics and Tuning Guide](https://docs.praxa.io/benchmarks/performance.md): Performance characteristics of the Praxa SDK: mission latency, SSE streaming overhead, automatic retry backoff, and concurrent mission fan-out patterns.
- [Praxa CLI Commands: Flags, Env Vars, and Usage Examples](https://docs.praxa.io/cli/commands.md): Full reference for praxa CLI commands: version, doctor, mission get, create, and cancel. Covers required flags, environment variables, and example output.
- [Praxa CLI: Manage Agent Missions from the Terminal](https://docs.praxa.io/cli/overview.md): @praxa/cli submits, inspects, and cancels Praxa missions from the terminal. Install globally or run on demand with npx — no provider credentials needed.
- [Capabilities: Discover What Your Praxa Agent Can Do](https://docs.praxa.io/concepts/capabilities.md): Capabilities are actions and integrations that Praxa missions can invoke. Use the capability search API to discover and verify what your gateway supports.
- [Memory, Context, and World Model in Praxa Missions](https://docs.praxa.io/concepts/memory-and-context.md): Praxa missions draw on persistent memory, context-twin goals, and a signed world model. Learn how to query each source to build context-aware agents.
- [Understanding Praxa Missions: Goals, Steps, and Lifecycle](https://docs.praxa.io/concepts/missions.md): A mission is the core unit of work in Praxa: a governed, goal-directed agent task. Learn about mission structure, lifecycle states, and real-time events.
- [Resource Budgets: Cap Steps, Time, and Parallelism](https://docs.praxa.io/concepts/resource-budgets.md): Resource budgets define hard limits on steps, tool calls, elapsed time, and parallelism. Every Praxa mission requires a budget enforced by the gateway.
- [What is Praxa? The Credential-Free Mission Platform](https://docs.praxa.io/introduction.md): Credential-free agentic mission platform. Learn how Praxa missions work, what the Integration Gateway does, and how provider keys stay out of your code.
- [Praxa MCP Contracts: Protocol Definitions for AI Agents](https://docs.praxa.io/mcp/overview.md): @praxa/mcp-contracts exports MCP 2025-03-26 tool definitions for Praxa. Register these typed schemas with any MCP-compatible AI agent server in minutes.
- [Praxa MCP Tools: Reference for All 11 Tool Definitions](https://docs.praxa.io/mcp/tools.md): Reference for all 11 Praxa MCP tools: input schemas, OAuth scopes, HTTP paths, and idempotency behavior for the Praxa Integration Gateway.
- [Praxa Quickstart: Submit Your First Mission in 5 Minutes](https://docs.praxa.io/quickstart.md): Install the Praxa TypeScript SDK, configure your gateway connection, and run your first AI agent mission in under 5 minutes. Requires Node.js 20 or later.
- [Praxa SDK Error Handling — PraxaClientError Reference](https://docs.praxa.io/sdk/error-handling.md): PraxaClientError carries an HTTP status code and RFC 9457 problem details. Learn to catch, inspect, and respond to Praxa SDK errors in TypeScript.
- [Stream Praxa Mission Events via Server-Sent Events (SSE)](https://docs.praxa.io/sdk/mission-events.md): missionEvents() returns an async generator streaming live SSE lifecycle events from a Praxa mission. Learn to consume, filter, cancel, and resume streams.
- [@praxa/sdk — Praxa TypeScript SDK Overview and Install](https://docs.praxa.io/sdk/overview.md): @praxa/sdk is the official TypeScript client for the Praxa Integration Gateway. Submit missions, stream events, and query capabilities from Node.js.
- [PraxaClient SDK Reference — Methods, Options, and Examples](https://docs.praxa.io/sdk/praxaclient.md): Full PraxaClient reference for @praxa/sdk. Covers constructor options, every method signature, and working examples for missions, capabilities, and memory.
- [Integrate Praxa Capabilities with MCP-Compatible Agents](https://docs.praxa.io/use-cases/mcp-integration.md): Add Praxa to any MCP-compatible agent with @praxa/mcp-contracts. Get typed tool definitions, input schemas, and OAuth scopes for all 11 Praxa operations.
- [Monitor and Observe Your Praxa Agent Missions in Real Time](https://docs.praxa.io/use-cases/monitoring-and-observability.md): Track mission progress, inspect execution traces, and retrieve skill details to understand how your Praxa agent missions are running and diagnose issues.
- [Build Multi-Step AI Agent Workflows with Praxa Missions](https://docs.praxa.io/use-cases/multi-step-workflows.md): Orchestrate complex multi-step AI agent workflows with Praxa missions. Send signals mid-execution and stream live progress events to your users.
- [Automate Recurring Tasks with Praxa Agent Missions](https://docs.praxa.io/use-cases/task-automation.md): Use Praxa missions to automate tasks like report generation, summarization, and content creation without managing AI provider credentials.