---
title: "Start Codex authorization-code OAuth"
method: POST
path: "/api/projects/{projectId}/credentials/codex/authorize"
tags: ["Credentials"]
---

# Start Codex authorization-code OAuth

`POST /api/projects/{projectId}/credentials/codex/authorize`

Start Codex authorization-code OAuth. Accepts a JSON request body when defined and returns the resulting resource or action status.

## Path parameters

- `projectId` string, required

## Request body

- CodexAuthorizeRequest — codex Authorize Request payload accepted by the API.
  - `redirectUri` string, required — OAuth redirect URI.

## Response `200`

Authorization URL

- CodexAuthorizeResponse — codex Authorize Response payload returned by the API.
  - `url` string, required — URL for a browser or API client to use.
  - `verifier` string, required — PKCE verifier used by OAuth code exchange.
  - `state` string, required — OAuth state correlation value.
  - `redirectUri` string, required — OAuth redirect URI.
  - `callbackListening` boolean, required — callback Listening value for the codex Authorize Response object.

---

[API](https://skmtc.net/ibuildthecloud/apis/discobot-server-api.md) · [All operations](https://skmtc.net/ibuildthecloud/apis/discobot-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibuildthecloud/discobot-server-api/versions/4de3fcd6be56/schema)