Skip to content
ParcelOps
Start free
Back to docs

Partner admin API

Partner admin API.

Partners can add users, control which sources each one can reach, and read usage. Full request and response detail is shared during partner onboarding.

Talk to the partner teamBrowse connectors

Authentication

Bearer token, per partner.

Every request uses a partner-admin token issued to your backend. Send it as a bearer token. Never expose it in client code.

Authorization header

HTTP

Authorization: Bearer po_part_...

Endpoints

What you can call.

Users & Tenants

Mirror partner tenants and users into ParcelOps and issue per-user MCP bearer tokens.

  • POST/api/partner-admin/users

    Provision or reactivate a partner user

  • POST/api/partner-admin/users/{userId}/rotate-token

    Rotate a user's MCP bearer token

Connector Entitlements

Create partner-scoped connector entitlements without exposing premium connector secrets to ParcelOps.

  • GET/api/partner-admin/connections

    List connector entitlements

  • POST/api/partner-admin/connections

    Create a connector entitlement

  • PUT/api/partner-admin/connections/{id}

    Rotate connector custody reference

  • DELETE/api/partner-admin/connections/{id}

    Disable a connector entitlement

Usage & Billing

Read current usage, inspect closed billing periods, and submit partner seat reports.

  • GET/api/partner-admin/usage/current

    Read current-period usage

  • GET/api/partner-admin/usage/periods

    List closed usage periods

  • GET/api/partner-admin/usage/periods/{periodId}

    Read one usage period

  • POST/api/partner-admin/usage/periods/{periodId}/self-report

    Submit partner seat report

Next steps

CLIRun and test locallySDKIntegrate it in your appConnectorsBrowse what you can reach