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
- Type: stringrequired
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. - Type: stringFormat: urirequired
Must exactly match one of the client's registered redirect URIs. For a registered loopback URI (
http://127.0.0.1,http://[::1]orhttp://localhost) the port may differ (RFC 8252); scheme, host, path and query must still match. - enumconst:coderequired
- Type: string
Space- or comma-separated scopes. Must be a subset of what the client may request; omitted means everything the client is allowed. See
scopes_supportedin the server metadata. - Type: stringrequired
Opaque value returned unchanged on the redirect. Required.
- Type: stringmin length:43max length:128required
PKCE challenge: base64url(SHA-256(code_verifier)).
- enumconst:S256required
- Type: stringFormat: uri
RFC 8707 resource indicator naming the SignStack resource the tokens are for. Defaults to the REST API (the
resourcein/.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 witherror,error_description,stateandiss.- text/html
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'
