Quickstart

Email hello@part3.ca with the organizations you need access to and the scopes you need (e.g. project:read, document:read). We'll provision a credential pair:

• Client ID — public identifier
• Client Secret — store this in a secret manager; it's shown once

Each credential is bound to specific orgs / projects and a set of bitwise permissions.

Client credentials are exchanged for a short-lived JWT at the /v1/oauth/token endpoint.

curl -X POST https://api.part3.io/v1/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

Response:

{
  "access_token": "eyJhbGci...",
  "token_type": "Bearer",
  "expires_in": 3600
}

curl https://api.part3.io/v1/organizations/YOUR_ORG_ID/projects \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

You should see a list of projects scoped to the organization your key can access.

If you're using Claude Code and you have a Part3 user account, skip the REST API entirely and connect directly via MCP. One command:

claude mcp add --transport http part3 https://mcp.part3.io

No header needed — MCP uses browser-based OAuth. On first use, Claude opens a browser to sign in as your Part3 user. Currently restricted to Project Primes. See the MCP setup guide for details.