Documentation

esc
    API reference · Platform / Account

    Account

    Check which organization an API key acts for, what it may do and when it expires.

    View as MarkdownOpen in ClaudeOpen in ChatGPT

    Call GET /me first: it confirms the key works, and tells you its scopes before you try anything they do not allow.

    Describe this API key

    The organization and project the key acts in, its scopes and when it expires. Call it to check that a key works before using it.

    GET/public/v1/me
    Read keyReturns200OK

    Headers

    • Authorizationstringrequired

      Bearer and your API key: Bearer PAN_….

    Response 200

    The key.
    • organization_idstringrequired

      The organization the key belongs to.

    • project_idstringrequired

      The organization's project; every resource belongs to it.

    • api_keyobjectrequired
      Show 6 child fields
      • idstringrequired
      • namestringrequired
      • kindstringrequired

        standard for a key made under Organization › API keys; ai_app for the key an AI app was given when a member connected it.

        One of standard, ai_app.

      • client_namestring or nullrequired

        The AI app's name as it introduced itself (not verified by Pantech), e.g. Research assistant. Null for a standard key.

      • scopesarray of stringrequired

        delete appears only on an AI app's key, together with write.

      • expires_atstring or nullrequired

    Errors

    • 401UNAUTHENTICATED: the request has no API key, or the key is mistyped, revoked or expired, or its creator has left the organization. Send Authorization: Bearer PAN_… with a valid key; create one in the console under Organization › API keys.
    • 403INSUFFICIENT_SCOPE: the API key lacks the scope this endpoint needs (read for GET, write for changes; an AI app's key also needs delete for a destructive call). Use a key with that scope, or reconnect the AI app with "Manage and delete" access. FORBIDDEN: the member who created the key may not do this in the organization. Use a key created by an owner or admin. AI_APPS_DISABLED: the organization has turned AI app access off, and this request was made with an AI app's key or sent by Pantech's MCP server (Pantech-Client: mcp/…). An owner can turn it on in the console under Organization › AI apps.
    • 429RATE_LIMITED: this API key, verified user or organization used its request budget for the current window, or this address exceeded an IP/failed-auth limit. Wait Retry-After seconds, then retry. For authenticated quota denials, RateLimit-Scope identifies the denying quota and RateLimit-Reset reports its remaining window in seconds.
    • 503SERVICE_UNAVAILABLE: request quota storage is unavailable. Wait a few seconds, then retry.

    Every code is explained in Errors.

    Authorization
    curl "https://api.pantechdynamics.com/public/v1/me" \
  -H "Authorization: Bearer $PANTECH_API_KEY"
    Response 200
    {
  "organization_id": "org_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "project_id": "acc_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "api_key": {
    "id": "id",
    "name": "web-1",
    "kind": "standard",
    "client_name": "Research assistant",
    "scopes": [
      "read"
    ],
    "expires_at": "2026-10-03T09:30:00Z"
  }
}

    Revoke this API key

    Revokes the API key that sends this request, at once and for good. This is how an AI app disconnects itself and how pantech auth logout ends its key. Other keys are untouched.

    It needs no Idempotency-Key: once the key is revoked, repeating the call gets 401 UNAUTHENTICATED, because the key no longer works. It works even while the organization has AI app access turned off.

    Scope: read (any key may revoke itself).

    DELETE/public/v1/me
    Read keyReturns204No Content

    Headers

    • Authorizationstringrequired

      Bearer and your API key: Bearer PAN_….

    Response 204

    The key is revoked. No body.

    Errors

    • 401UNAUTHENTICATED: the request has no API key, or the key is mistyped, revoked or expired, or its creator has left the organization. Send Authorization: Bearer PAN_… with a valid key; create one in the console under Organization › API keys.
    • 403INSUFFICIENT_SCOPE: the API key lacks the scope this endpoint needs (read for GET, write for changes; an AI app's key also needs delete for a destructive call). Use a key with that scope, or reconnect the AI app with "Manage and delete" access. FORBIDDEN: the member who created the key may not do this in the organization. Use a key created by an owner or admin. AI_APPS_DISABLED: the organization has turned AI app access off, and this request was made with an AI app's key or sent by Pantech's MCP server (Pantech-Client: mcp/…). An owner can turn it on in the console under Organization › AI apps.
    • 429RATE_LIMITED: this API key, verified user or organization used its request budget for the current window, or this address exceeded an IP/failed-auth limit. Wait Retry-After seconds, then retry. For authenticated quota denials, RateLimit-Scope identifies the denying quota and RateLimit-Reset reports its remaining window in seconds.
    • 503SERVICE_UNAVAILABLE: request quota storage is unavailable. Wait a few seconds, then retry.

    Every code is explained in Errors.

    Authorization
    curl -X DELETE "https://api.pantechdynamics.com/public/v1/me" \
  -H "Authorization: Bearer $PANTECH_API_KEY"
    HTTP/1.1 204 No Content

    Was this page helpful?

    Updated