Back to docsAPI reference

Partner admin API.

Programmatic access for partners to provision users, manage connector entitlements, and read usage. Full request and response detail is shared during partner onboarding.

Authentication

Bearer token, per partner.

Every request authenticates with 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 PatchOps 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 PatchOps.

  • 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