OAuth

OAUTH Authorize Prior Grant

The user's existing grant for the ceremony's client, one entry per granted connection.

Lets a reconnect card pre-select the exact account and level the user already granted rather than the app's requested set, so re-authorizing cannot silently widen a grant they had narrowed. A single durable-grant read keyed on the caller and the ceremony's client, filtered to the tenant the card is opened in: the request carries the same X-One-Organization-Id / X-One-Project-Id selectors as the connections read, so a grant made in one tenant is never pre-selected in another. The domain proves ceremony ownership.

get/oauth/authorize/prior-grant

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/oauth/authorize/prior-grant
  • Auth: Session (a scheme the document does not define)

Query parameters

state_keystring required

Headers

X-One-Organization-Idstring uuid nullable

Selects the organization the card is opened in, so the grant is filtered to it. Omit it to read a personal-scope grant; a grant made under an organization is not returned in personal scope.

X-One-Project-Idstring uuid nullable

Selects the project the card is opened in, inside the organization above. A project-limited grant is returned only at its own project scope, never at the parent organization.

Response

The caller's grant for the client in the selected tenant, or null when they have not authorized it there

OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.