Skip to main content
POST
Start Codex subscription device authorization
CLI:

Overview

Start Codex subscription device authorization This page documents post /api/integrations/codex/start. Use the request and response sections on this page for accepted parameters, payload fields, response fields, and authentication behavior.

AI agent notes

  • Confirm the operation matches the user’s intent before calling it.
  • For write operations, confirm the user intends to change state.
  • Surface validation, permission, and not-found errors instead of retrying unchanged.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Authorization ceremony started or reused.

state
enum<string>
required
Available options:
starting