Start an authorization (authorization code + PKCE)

​

Starts the OAuth 2.1 authorization-code flow for a registered client. SignStack validates the request, stores it for ten minutes, and redirects the user to the consent screen in Studio, where they sign in, choose an organization and a namespace, and approve. On approval the user is sent back to redirect_uri with code, state and iss; on denial or any later validation failure, with error, error_description and state.

PKCE is mandatory (code_challenge_method=S256) for confidential and public clients alike, and state is required.

An unknown client_id or a redirect_uri that is not registered for the client is answered with an HTML error page (400) and never a redirect.

Query Parameters

  • The client id SignStack issued at registration (oc_…), or, for a client that publishes a Client ID Metadata Document, the HTTPS URL of that document.

  • Must exactly match one of the client's registered redirect URIs. For a registered loopback URI (http://127.0.0.1, http://[::1] or http://localhost) the port may differ (RFC 8252); scheme, host, path and query must still match.

  • Space- or comma-separated scopes. Must be a subset of what the client may request; omitted means everything the client is allowed. See scopes_supported in the server metadata.

  • Opaque value returned unchanged on the redirect. Required.

  • PKCE challenge: base64url(SHA-256(code_verifier)).

  • RFC 8707 resource indicator naming the SignStack resource the tokens are for. Defaults to the REST API (the resource in /.well-known/oauth-protected-resource).

Responses

  • Redirect to the Studio consent screen, or — on a validation error with a trusted redirect_uri — back to the client with error, error_description, state and iss.

  • text/html
Request Example for get/v1/oauth/authorize
curl 'https://api.signstack.ai/v1/oauth/authorize?client_id=oc_01jv8m7qfj6xj9gkz7a4s2h8e&redirect_uri=https%3A%2F%2Fexample.com&response_type=code&scope=workflow%3Aread%20workflow%3Acreate%20resource%3Aread&state=&code_challenge=&code_challenge_method=S256'
No Body