---
title: "OAuth2 authorization-code + PKCE"
method: GET
path: "/v1/oauth/authorize"
---

# OAuth2 authorization-code + PKCE

`GET /v1/oauth/authorize`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/oauth/authorize`
- Auth: none required

## Query parameters

- `client_id` string, required
- `redirect_uri` string, required
- `code_challenge` string, required
- `state` string
- `response_type` 'code'

## Response `default`

Error envelope

- ErrorEnvelope
  - `error` ErrorBody, required
    - `code` 'unsupported_query' | 'unsupported_predicate' | 'unsupported_entity_family' | 'ambiguous_geo' | 'capability_pending' | 'source_blocked' | 'challenge_page' | 'unquoted_plan' | 'compiler_unavailable' | 'parse_failed' | 'payments_not_live' | 'capacity' | 'kill_switch' | 'internal_failure' | 'plan_required', required
    - `message` string, required
    - `details` object

## Other responses

- `302`: Redirect with code

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)
