Primitive REST API

REST discovered

Details

URL: https://api.primitive.dev/v1
Docs: https://docs.primitive.dev/docs/api

Authentication

Primitive API key api_key discovered Get key ↗

Authorization: Bearer <credential>

Create an API key in Settings → API Keys. For headless agents, you can also mint one with the unauthenticated POST https://api.primitive.dev/v1/agent/accounts flow described in auth.md. Use the returned prim_... value as a Bearer token.

Primitive OAuth public client + user grant oauth2 discovered Set up OAuth ↗

Authorization: Bearer <credential>

Register a public client with OAuth dynamic client registration as described in Authentication & API Keys. Then run the Authorization Code + PKCE flow against `/oauth/authorize` and `/oauth/token`, or let the CLI do it via primitive login. This yields a prim_oat_... access token and a refresh token for the authorized organization.