{"openapi":"3.1.0","info":{"title":"Codex API Adapter","description":"Versioned HTTP adapter for the local OpenAI Codex app-server.\n\nThis API keeps live web search enabled by default, preserves returning-user history by resuming the latest thread for a managed project workspace, exposes a stable `/api/v1` project-scoped surface for browser-based coding agents, retains a protected raw JSON-RPC passthrough for strict Codex app-server compatibility, and supports approval-aware coding workflows with project-scoped approval polling and resolution.\n\nAuthentication accepts static bearer tokens from environment variables, managed PostgreSQL-backed API keys created in the admin dashboard, and Codex API usernames as standard API bearer tokens for wallet-linked client calls.","version":"1.0.48"},"paths":{"/api/status/regions":{"get":{"tags":["system"],"summary":"Regional API availability","operationId":"public_regional_availability_api_status_regions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Regional Availability Api Status Regions Get"}}}}}}},"/api/v1/status/regions":{"get":{"tags":["system"],"summary":"Regional API availability","operationId":"public_regional_availability_api_v1_status_regions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Regional Availability Api V1 Status Regions Get"}}}}}}},"/v1/models":{"get":{"tags":["openai-compatible"],"summary":"List CodexAPI.pro models for stock public Codex CLI","operationId":"openai_compatible_models_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Compatible Models V1 Models Get"}}}}},"security":[{"ApiBearer":[]}],"description":"Power AI is a managed model alias. Send model=power-ai to use the service's configured Power AI destination. The selected provider can change without changing this model ID. Existing account billing and key restrictions apply."}},"/v1/responses":{"post":{"tags":["openai-compatible"],"summary":"Proxy stock public Codex CLI Responses API traffic through CodexAPI.pro wallet billing","operationId":"openai_compatible_responses_v1_responses_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiBearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"examples":{"power_ai":{"summary":"Power AI - a first request","value":{"model":"power-ai","input":"Reply exactly OK.","max_output_tokens":64}},"power_ai_stream":{"summary":"Power AI - streaming","value":{"model":"power-ai","input":"Reply exactly OK.","max_output_tokens":64,"stream":true}}}}}},"description":"Power AI is a managed model alias. Send model=power-ai to use the service's configured Power AI destination. The selected provider can change without changing this model ID. Existing account billing and key restrictions apply."}},"/v1/responses/count_tokens":{"post":{"tags":["openai-compatible"],"summary":"Estimate input tokens for an OpenAI-compatible Responses payload","operationId":"openai_compatible_responses_count_tokens_v1_responses_count_tokens_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Compatible Responses Count Tokens V1 Responses Count Tokens Post"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/responses/{response_id}":{"get":{"tags":["openai-compatible"],"summary":"Retrieve a locally cached OpenAI-compatible Responses object","operationId":"openai_compatible_get_response_v1_responses__response_id__get","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Get Response V1 Responses  Response Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"delete":{"tags":["openai-compatible"],"summary":"Delete a locally cached OpenAI-compatible Responses object","operationId":"openai_compatible_delete_response_v1_responses__response_id__delete","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Delete Response V1 Responses  Response Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/responses/{response_id}/input_items":{"get":{"tags":["openai-compatible"],"summary":"List input items captured for a locally cached Responses object","operationId":"openai_compatible_response_input_items_v1_responses__response_id__input_items_get","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Response Input Items V1 Responses  Response Id  Input Items Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/responses/{response_id}/cancel":{"post":{"tags":["openai-compatible"],"summary":"Cancel a Responses request if it is still pending","operationId":"openai_compatible_cancel_response_v1_responses__response_id__cancel_post","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Cancel Response V1 Responses  Response Id  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/responses/{response_id}/compact":{"post":{"tags":["openai-compatible"],"summary":"Return a compacted summary of a locally cached Responses object","operationId":"openai_compatible_compact_response_v1_responses__response_id__compact_post","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Compact Response V1 Responses  Response Id  Compact Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/models/{model_id}":{"get":{"tags":["openai-compatible"],"summary":"Retrieve one CodexAPI.pro model descriptor","operationId":"openai_compatible_model_v1_models__model_id__get","parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string","title":"Model Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Model V1 Models  Model Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/chat/completions":{"post":{"tags":["openai-compatible"],"summary":"Create an OpenAI-compatible Chat Completion using the active CodexAPI.pro routing policy","operationId":"openai_compatible_chat_completions_v1_chat_completions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiBearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"examples":{"power_ai":{"summary":"Power AI - a first request","value":{"model":"power-ai","max_tokens":64,"messages":[{"role":"user","content":"Reply exactly OK."}]}},"power_ai_stream":{"summary":"Power AI - streaming","value":{"model":"power-ai","max_tokens":64,"messages":[{"role":"user","content":"Reply exactly OK."}],"stream":true}},"power_ai_tool":{"summary":"Power AI - local function call","value":{"model":"power-ai","messages":[{"role":"user","content":"Use get_project_name to read the current project name."}],"tools":[{"type":"function","function":{"name":"get_project_name","description":"Read the name of the current project.","parameters":{"type":"object","properties":{},"additionalProperties":false}}}],"tool_choice":{"type":"function","function":{"name":"get_project_name"}},"max_tokens":256}}}}}},"description":"Power AI is a managed model alias. Send model=power-ai to use the service's configured Power AI destination. The selected provider can change without changing this model ID. Existing account billing and key restrictions apply."},"get":{"tags":["openai-compatible"],"summary":"List locally cached Chat Completions for this bearer","operationId":"openai_compatible_list_chat_completions_v1_chat_completions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible List Chat Completions V1 Chat Completions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/chat/completions/{completion_id}":{"get":{"tags":["openai-compatible"],"summary":"Retrieve a locally cached Chat Completion","operationId":"openai_compatible_get_chat_completion_v1_chat_completions__completion_id__get","parameters":[{"name":"completion_id","in":"path","required":true,"schema":{"type":"string","title":"Completion Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Get Chat Completion V1 Chat Completions  Completion Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"patch":{"tags":["openai-compatible"],"summary":"Update metadata for a locally cached Chat Completion","operationId":"openai_compatible_update_chat_completion_v1_chat_completions__completion_id__patch","parameters":[{"name":"completion_id","in":"path","required":true,"schema":{"type":"string","title":"Completion Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Update Chat Completion V1 Chat Completions  Completion Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"delete":{"tags":["openai-compatible"],"summary":"Delete a locally cached Chat Completion","operationId":"openai_compatible_delete_chat_completion_v1_chat_completions__completion_id__delete","parameters":[{"name":"completion_id","in":"path","required":true,"schema":{"type":"string","title":"Completion Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Openai Compatible Delete Chat Completion V1 Chat Completions  Completion Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/v1/completions":{"post":{"tags":["openai-compatible"],"summary":"Create a legacy OpenAI-compatible text completion using the active Responses route","operationId":"openai_compatible_completions_v1_completions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiBearer":[]}]}},"/v1/messages":{"post":{"tags":["anthropic-compatible"],"summary":"Proxy Claude Code CLI Messages API traffic through CodexAPI.pro wallet billing","operationId":"anthropic_compatible_messages_v1_messages_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiBearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"examples":{"power_ai":{"summary":"Power AI - a first request","value":{"model":"power-ai","max_tokens":64,"messages":[{"role":"user","content":"Reply exactly OK."}]}},"power_ai_stream":{"summary":"Power AI - streaming","value":{"model":"power-ai","max_tokens":64,"messages":[{"role":"user","content":"Reply exactly OK."}],"stream":true}}}}}},"description":"Power AI is a managed model alias. Send model=power-ai to use the service's configured Power AI destination. The selected provider can change without changing this model ID. Existing account billing and key restrictions apply.","parameters":[{"in":"header","name":"anthropic-version","required":false,"schema":{"type":"string","default":"2023-06-01"}}]}},"/v1/messages/{subpath}":{"post":{"tags":["anthropic-compatible"],"summary":"Proxy Claude Code CLI auxiliary Messages API traffic","operationId":"anthropic_compatible_messages_subpath_v1_messages__subpath__post","parameters":[{"name":"subpath","in":"path","required":true,"schema":{"type":"string","title":"Subpath"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/models":{"get":{"tags":["rpc"],"summary":"List visible Codex models","operationId":"list_models_api_models_get","parameters":[{"name":"include_hidden","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Hidden"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Models Api Models Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/threads":{"get":{"tags":["threads"],"summary":"List Codex threads","operationId":"list_threads_api_threads_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Limit"}},{"name":"cwd","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cwd"}},{"name":"archived","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Archived"}},{"name":"search_term","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Term"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Threads Api Threads Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["threads"],"summary":"Start a new thread","operationId":"start_thread_api_threads_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadStartBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Start Thread Api Threads Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/threads/{thread_id}":{"get":{"tags":["threads"],"summary":"Read a thread by id","operationId":"read_thread_api_threads__thread_id__get","parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}},{"name":"include_turns","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Turns"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Read Thread Api Threads  Thread Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/threads/{thread_id}/resume":{"post":{"tags":["threads"],"summary":"Resume an existing thread","operationId":"resume_thread_api_threads__thread_id__resume_post","parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Resume Thread Api Threads  Thread Id  Resume Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/turns":{"post":{"tags":["turns"],"summary":"Start a new turn on a thread","operationId":"start_turn_api_turns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TurnStartBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Start Turn Api Turns Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/turns/{turn_id}/interrupt":{"post":{"tags":["turns"],"summary":"Interrupt an active turn","operationId":"interrupt_turn_api_turns__turn_id__interrupt_post","parameters":[{"name":"turn_id","in":"path","required":true,"schema":{"type":"string","title":"Turn Id"}},{"name":"thread_id","in":"query","required":true,"schema":{"type":"string","title":"Thread Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Interrupt Turn Api Turns  Turn Id  Interrupt Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/projects/open":{"post":{"tags":["threads"],"summary":"Open a project by cwd, resuming the latest matching thread when present","operationId":"project_open_api_projects_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectOpenBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Project Open Api Projects Open Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/reddit/conversion":{"post":{"tags":["analytics"],"summary":"Send a server-side Reddit Conversions API website event","operationId":"v1_reddit_conversion_api_v1_reddit_conversion_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedditConversionBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Reddit Conversion Api V1 Reddit Conversion Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/human-check":{"get":{"tags":["auth"],"summary":"Create a self-hosted signup human-verification challenge","operationId":"v1_signup_human_check_api_v1_auth_human_check_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/cli/version":{"get":{"tags":["system"],"summary":"Read the current CodexAPI.pro Codex CLI release metadata","operationId":"v1_chatplus_cli_version_api_v1_cli_version_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Cli Version Api V1 Cli Version Get"}}}}}}},"/api/v1/codexclaude/version":{"get":{"tags":["system"],"summary":"Read the required CodexAPI.pro codexclaude launcher version","operationId":"v1_codexclaude_version_api_v1_codexclaude_version_get","parameters":[{"name":"current","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Installed codexclaude version.","title":"Current"},"description":"Installed codexclaude version."},{"name":"currentVersion","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Installed codexclaude version alias.","title":"Currentversion"},"description":"Installed codexclaude version alias."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Codexclaude Version Api V1 Codexclaude Version Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/claudecodex/version":{"get":{"tags":["system"],"summary":"Read the required CodexAPI.pro claudecodex launcher version","operationId":"v1_claudecodex_version_api_v1_claudecodex_version_get","parameters":[{"name":"current","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Installed claudecodex version.","title":"Current"},"description":"Installed claudecodex version."},{"name":"currentVersion","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Installed claudecodex version alias.","title":"Currentversion"},"description":"Installed claudecodex version alias."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Claudecodex Version Api V1 Claudecodex Version Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gumroad/register":{"post":{"tags":["auth"],"summary":"Create a Gumroad.com buyer account and load $200 Token Wallet credit","operationId":"v1_gumroad_register_api_v1_gumroad_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GumroadRegisterBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Gumroad Register Api V1 Gumroad Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/google/start":{"get":{"tags":["auth"],"summary":"Start Google sign-up or sign-in for a CodexAPI.pro wallet account","operationId":"v1_google_auth_start_api_v1_auth_google_start_get","parameters":[{"name":"planId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Planid"}},{"name":"amountUsd","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amountusd"}},{"name":"returnTo","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"/dashboard.html","title":"Returnto"}},{"name":"deviceFingerprint","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Devicefingerprint"}},{"name":"countryCode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Countrycode"}},{"name":"countryName","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Countryname"}},{"name":"mobileNumber","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobilenumber"}},{"name":"referralCode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referralcode"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"humanCheckId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Humancheckid"}},{"name":"humanCheckAnswer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Humancheckanswer"}},{"name":"website","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/google/callback":{"get":{"tags":["auth"],"summary":"Complete Google sign-up or sign-in for a CodexAPI.pro wallet account","operationId":"v1_google_auth_callback_api_v1_auth_google_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response V1 Google Auth Callback Api V1 Auth Google Callback Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/customer/register":{"post":{"tags":["auth"],"summary":"Create a CodexAPI.pro customer account and issue a wallet-linked API key","operationId":"v1_chatplus_register_api_v1_customer_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusRegisterBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Register Api V1 Customer Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/login":{"post":{"tags":["auth"],"summary":"Authenticate a CodexAPI.pro CLI user and issue a wallet-linked API key","operationId":"v1_chatplus_login_api_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusLoginBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Login Api V1 Auth Login Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/web-login":{"post":{"tags":["auth"],"summary":"Authenticate a CodexAPI.pro dashboard user","operationId":"v1_chatplus_web_login_api_v1_auth_web_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusLoginBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Web Login Api V1 Auth Web Login Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/web-login/2fa":{"post":{"tags":["auth"],"summary":"Complete CodexAPI.pro dashboard login with a Google Authenticator code","operationId":"v1_chatplus_web_login_two_factor_api_v1_auth_web_login_2fa_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusTwoFactorVerifyBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Web Login Two Factor Api V1 Auth Web Login 2Fa Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/password-reset/request":{"post":{"tags":["auth"],"summary":"Email a short-lived dashboard password reset link","operationId":"v1_chatplus_password_reset_request_api_v1_auth_password_reset_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Password Reset Request Api V1 Auth Password Reset Request Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/password-reset/confirm":{"post":{"tags":["auth"],"summary":"Set a new dashboard password from a reset link","operationId":"v1_chatplus_password_reset_confirm_api_v1_auth_password_reset_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetConfirmBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Password Reset Confirm Api V1 Auth Password Reset Confirm Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/sso":{"get":{"tags":["auth"],"summary":"Open the customer dashboard from a signed notification link","operationId":"v1_chatplus_sso_api_v1_auth_sso_get","parameters":[{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"returnTo","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Returnto"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/status":{"get":{"tags":["billing"],"summary":"Read a lightweight wallet balance snapshot for CLI launchers","operationId":"v1_wallet_status_api_v1_wallet_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Wallet Status Api V1 Wallet Status Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me":{"get":{"tags":["auth"],"summary":"Read the current CodexAPI.pro customer wallet and CLI configuration","operationId":"v1_chatplus_me_api_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Me Api V1 Me Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/purchase-preferences":{"get":{"tags":["billing"],"summary":"Read Deposit, low-balance, and business receipt preferences","operationId":"v1_purchase_preferences_api_v1_purchase_preferences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Purchase Preferences Api V1 Purchase Preferences Get"}}}}},"security":[{"ApiBearer":[]}]},"put":{"tags":["billing"],"summary":"Save Deposit, low-balance, and business receipt preferences","operationId":"v1_update_purchase_preferences_api_v1_purchase_preferences_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchasePreferencesBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Update Purchase Preferences Api V1 Purchase Preferences Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/customer-engagement":{"get":{"tags":["dashboard"],"summary":"Read promotion history, eligibility, and notification preferences","operationId":"v1_customer_engagement_api_v1_customer_engagement_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Customer Engagement Api V1 Customer Engagement Get"}}}}},"security":[{"ApiBearer":[]}]},"put":{"tags":["dashboard"],"summary":"Save promotion, reminder, timezone, and motion preferences","operationId":"v1_update_customer_engagement_api_v1_customer_engagement_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerEngagementPreferencesBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Update Customer Engagement Api V1 Customer Engagement Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/payments":{"get":{"tags":["billing"],"summary":"List Stripe wallet payments and receipt availability","operationId":"v1_wallet_payments_api_v1_wallet_payments_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Wallet Payments Api V1 Wallet Payments Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/billing/currency-estimates":{"get":{"tags":["billing"],"summary":"Read estimated local-currency conversions while checkout remains USD","operationId":"v1_currency_estimates_api_v1_billing_currency_estimates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Currency Estimates Api V1 Billing Currency Estimates Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/setup/health-check":{"post":{"tags":["auth"],"summary":"Run a non-billable account and setup readiness check","operationId":"v1_setup_health_check_api_v1_setup_health_check_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Setup Health Check Api V1 Setup Health Check Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/spin-wheel":{"get":{"tags":["billing"],"summary":"Read the current customer's Spin the Wheel promotion status","operationId":"v1_spin_wheel_status_api_v1_spin_wheel_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Spin Wheel Status Api V1 Spin Wheel Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/spin-wheel/spin":{"post":{"tags":["billing"],"summary":"Use the current customer's single Spin the Wheel entry","operationId":"v1_spin_wheel_spin_api_v1_spin_wheel_spin_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Spin Wheel Spin Api V1 Spin Wheel Spin Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/api-keys":{"get":{"tags":["auth"],"summary":"List the current customer's System Token and wallet-linked User API Keys","operationId":"v1_chatplus_user_api_keys_api_v1_me_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus User Api Keys Api V1 Me Api Keys Get"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["auth"],"summary":"Create a wallet-linked User API Key for the current customer","operationId":"v1_chatplus_create_user_api_key_api_v1_me_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserApiKeyCreateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Create User Api Key Api V1 Me Api Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/vip":{"get":{"tags":["auth"],"summary":"Read the current customer's VIP Priority server access","operationId":"v1_chatplus_vip_api_v1_vip_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Vip Api V1 Vip Get"}}}}}}},"/api/v1/me/api-keys/{key_id}":{"delete":{"tags":["auth"],"summary":"Revoke one of the current customer's User API Keys","operationId":"v1_chatplus_delete_user_api_key_api_v1_me_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus Delete User Api Key Api V1 Me Api Keys  Key Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"patch":{"tags":["auth"],"summary":"Update a customer User API Key policy","operationId":"v1_chatplus_update_user_api_key_api_v1_me_api_keys__key_id__patch","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserApiKeyUpdateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus Update User Api Key Api V1 Me Api Keys  Key Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/api-keys/{key_id}/replace":{"post":{"tags":["auth"],"summary":"Replace a customer User API Key immediately","operationId":"v1_chatplus_replace_user_api_key_api_v1_me_api_keys__key_id__replace_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus Replace User Api Key Api V1 Me Api Keys  Key Id  Replace Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/api-keys/{key_id}/usage":{"get":{"tags":["auth"],"summary":"Read usage for one customer User API Key","operationId":"v1_chatplus_user_api_key_usage_api_v1_me_api_keys__key_id__usage_get","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus User Api Key Usage Api V1 Me Api Keys  Key Id  Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/api-key-alerts":{"get":{"tags":["auth"],"summary":"List User API Key security and usage alerts","operationId":"v1_chatplus_user_api_key_alerts_api_v1_me_api_key_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus User Api Key Alerts Api V1 Me Api Key Alerts Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/api-key-alerts/{event_id}/acknowledge":{"post":{"tags":["auth"],"summary":"Acknowledge a User API Key alert","operationId":"v1_chatplus_acknowledge_user_api_key_alert_api_v1_me_api_key_alerts__event_id__acknowledge_post","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"integer","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus Acknowledge User Api Key Alert Api V1 Me Api Key Alerts  Event Id  Acknowledge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/api-keys/{key_id}/health":{"get":{"tags":["auth"],"summary":"Run a non-billable User API Key integration health check","operationId":"v1_chatplus_user_api_key_health_api_v1_me_api_keys__key_id__health_get","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus User Api Key Health Api V1 Me Api Keys  Key Id  Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/messages":{"get":{"tags":["auth"],"summary":"List the current customer's inbox messages","operationId":"v1_customer_messages_api_v1_messages_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Customer Messages Api V1 Messages Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/messages/{message_id}/read":{"post":{"tags":["auth"],"summary":"Mark a customer inbox message read","operationId":"v1_customer_message_read_api_v1_messages__message_id__read_post","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Customer Message Read Api V1 Messages  Message Id  Read Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/claude-desktop/sync":{"get":{"tags":["desktop"],"summary":"Read synchronized Claude Desktop conversation history","operationId":"v1_claude_desktop_sync_get_api_v1_claude_desktop_sync_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Claude Desktop Sync Get Api V1 Claude Desktop Sync Get"}}}}},"security":[{"ApiBearer":[]}]},"put":{"tags":["desktop"],"summary":"Synchronize Claude Desktop conversation history","operationId":"v1_claude_desktop_sync_put_api_v1_claude_desktop_sync_put","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Claude Desktop Sync Put Api V1 Claude Desktop Sync Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/claude-desktop/object-workspace":{"post":{"tags":["desktop"],"summary":"Ensure the current customer's private desktop object workspace","operationId":"v1_claude_desktop_object_workspace_api_v1_claude_desktop_object_workspace_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Claude Desktop Object Workspace Api V1 Claude Desktop Object Workspace Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/claude-desktop/object-workspace/projects":{"post":{"tags":["desktop"],"summary":"Create a private project folder in the current customer's desktop workspace","operationId":"v1_claude_desktop_object_project_api_v1_claude_desktop_object_workspace_projects_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Claude Desktop Object Project Api V1 Claude Desktop Object Workspace Projects Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/claude-desktop/object-workspace/projects/{project_id}":{"delete":{"tags":["desktop"],"summary":"Delete the current customer's private desktop project marker","operationId":"v1_claude_desktop_object_project_delete_api_v1_claude_desktop_object_workspace_projects__project_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Claude Desktop Object Project Delete Api V1 Claude Desktop Object Workspace Projects  Project Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/claude-desktop/object-workspace/repositories/{repository_name}":{"post":{"tags":["desktop"],"summary":"Store an authenticated customer's repository archive in their private desktop workspace","operationId":"v1_claude_desktop_object_repository_api_v1_claude_desktop_object_workspace_repositories__repository_name__post","parameters":[{"name":"repository_name","in":"path","required":true,"schema":{"type":"string","title":"Repository Name"}},{"name":"sourceUrl","in":"query","required":false,"schema":{"type":"string","default":"","title":"Sourceurl"}},{"name":"commit","in":"query","required":false,"schema":{"type":"string","default":"","title":"Commit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Claude Desktop Object Repository Api V1 Claude Desktop Object Workspace Repositories  Repository Name  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/claude-desktop/push":{"get":{"tags":["desktop"],"summary":"List persistent Claude Desktop service messages","operationId":"v1_claude_desktop_pushes_api_v1_claude_desktop_push_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Claude Desktop Pushes Api V1 Claude Desktop Push Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/claude-desktop/push/{message_key}/dismiss":{"post":{"tags":["desktop"],"summary":"Dismiss one Claude Desktop service message","operationId":"v1_claude_desktop_push_dismiss_api_v1_claude_desktop_push__message_key__dismiss_post","parameters":[{"name":"message_key","in":"path","required":true,"schema":{"type":"string","title":"Message Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Claude Desktop Push Dismiss Api V1 Claude Desktop Push  Message Key  Dismiss Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/toolbox":{"get":{"tags":["auth"],"summary":"Read the current customer Toolbox settings","operationId":"v1_toolbox_api_v1_toolbox_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Toolbox Api V1 Toolbox Get"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["auth"],"summary":"Update the current customer Toolbox settings","operationId":"v1_update_toolbox_api_v1_toolbox_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolboxSettingsBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Update Toolbox Api V1 Toolbox Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/sso-link":{"post":{"tags":["auth"],"summary":"Create a short-lived one-click dashboard sign-on link for the current customer","operationId":"v1_chatplus_sso_link_api_v1_me_sso_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashboardSsoLinkBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Sso Link Api V1 Me Sso Link Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/edge-region":{"post":{"tags":["auth"],"summary":"Set the current customer's preferred London or Chicago API server","operationId":"v1_set_my_edge_region_api_v1_me_edge_region_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Set My Edge Region Api V1 Me Edge Region Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop/bootstrap":{"get":{"tags":["desktop"],"summary":"Verify a CodexAPI.pro token and return Windows desktop setup payloads","operationId":"v1_desktop_bootstrap_api_v1_desktop_bootstrap_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":180,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Desktop Bootstrap Api V1 Desktop Bootstrap Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/bootstrap":{"get":{"tags":["desktop-chat"],"summary":"Load CodexAPI.pro Desktop Chat conversations, models, and free daily quota","operationId":"v1_desktop_chat_bootstrap_api_v1_desktop_chat_bootstrap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Desktop Chat Bootstrap Api V1 Desktop Chat Bootstrap Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/shoutbox/bootstrap":{"get":{"tags":["desktop-chat"],"summary":"Load the shared CodexAPI.pro Desktop Chat Shoutbox","operationId":"v1_desktop_chat_shoutbox_bootstrap_api_v1_desktop_chat_shoutbox_bootstrap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Desktop Chat Shoutbox Bootstrap Api V1 Desktop Chat Shoutbox Bootstrap Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/shoutbox/messages":{"get":{"tags":["desktop-chat"],"summary":"List shared CodexAPI.pro Desktop Chat Shoutbox messages","operationId":"v1_desktop_chat_shoutbox_messages_api_v1_desktop_chat_shoutbox_messages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Desktop Chat Shoutbox Messages Api V1 Desktop Chat Shoutbox Messages Get"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["desktop-chat"],"summary":"Send a shared CodexAPI.pro Desktop Chat Shoutbox message","operationId":"v1_send_desktop_chat_shoutbox_message_api_v1_desktop_chat_shoutbox_messages_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopShoutboxMessageBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Send Desktop Chat Shoutbox Message Api V1 Desktop Chat Shoutbox Messages Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/shoutbox/profile":{"post":{"tags":["desktop-chat"],"summary":"Set the user's shared Desktop Chat Shoutbox username","operationId":"v1_set_desktop_chat_shoutbox_profile_api_v1_desktop_chat_shoutbox_profile_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopShoutboxProfileBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Set Desktop Chat Shoutbox Profile Api V1 Desktop Chat Shoutbox Profile Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/conversations":{"get":{"tags":["desktop-chat"],"summary":"List CodexAPI.pro Desktop Chat conversations","operationId":"v1_desktop_chat_conversations_api_v1_desktop_chat_conversations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Desktop Chat Conversations Api V1 Desktop Chat Conversations Get"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["desktop-chat"],"summary":"Create a CodexAPI.pro Desktop Chat conversation","operationId":"v1_create_desktop_chat_conversation_api_v1_desktop_chat_conversations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopChatConversationCreateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Create Desktop Chat Conversation Api V1 Desktop Chat Conversations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/conversations/{conversation_id}":{"delete":{"tags":["desktop-chat"],"summary":"Delete a CodexAPI.pro Desktop Chat conversation","operationId":"v1_delete_desktop_chat_conversation_api_v1_desktop_chat_conversations__conversation_id__delete","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"integer","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Delete Desktop Chat Conversation Api V1 Desktop Chat Conversations  Conversation Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/conversations/{conversation_id}/messages":{"get":{"tags":["desktop-chat"],"summary":"Read CodexAPI.pro Desktop Chat conversation messages","operationId":"v1_desktop_chat_messages_api_v1_desktop_chat_conversations__conversation_id__messages_get","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"integer","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Desktop Chat Messages Api V1 Desktop Chat Conversations  Conversation Id  Messages Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["desktop-chat"],"summary":"Send a CodexAPI.pro Desktop Chat prompt with saved conversation context","operationId":"v1_send_desktop_chat_message_api_v1_desktop_chat_conversations__conversation_id__messages_post","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"integer","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopChatPromptBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Send Desktop Chat Message Api V1 Desktop Chat Conversations  Conversation Id  Messages Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop-chat/messages/{message_id}/research.pdf":{"get":{"tags":["desktop-chat"],"summary":"Download a completed Desktop Chat Deep Research analysis as a PDF","operationId":"v1_desktop_chat_research_pdf_api_v1_desktop_chat_messages__message_id__research_pdf_get","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop/coding-session":{"get":{"tags":["desktop"],"summary":"Load the saved CodexAPI.pro Desktop coding conversation history","operationId":"v1_desktop_coding_session_api_v1_desktop_coding_session_get","parameters":[{"name":"sessionKey","in":"query","required":false,"schema":{"type":"string","default":"desktop-default","title":"Sessionkey"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Desktop Coding Session Api V1 Desktop Coding Session Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"put":{"tags":["desktop"],"summary":"Persist CodexAPI.pro Desktop coding conversation history","operationId":"v1_save_desktop_coding_session_api_v1_desktop_coding_session_put","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopCodingSessionBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Save Desktop Coding Session Api V1 Desktop Coding Session Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop/coder/projects":{"get":{"tags":["desktop"],"summary":"List Windows Desktop Coding Mode projects and managed databases","operationId":"v1_desktop_coder_projects_api_v1_desktop_coder_projects_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Desktop Coder Projects Api V1 Desktop Coder Projects Get"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["desktop"],"summary":"Create or resume a Windows Desktop Coding Mode project","operationId":"v1_ensure_desktop_coder_project_api_v1_desktop_coder_projects_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopCoderProjectBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Ensure Desktop Coder Project Api V1 Desktop Coder Projects Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop/coder/projects/{project_name}":{"delete":{"tags":["desktop"],"summary":"Delete a Windows Desktop Coding Mode project and its managed database","operationId":"v1_delete_desktop_coder_project_api_v1_desktop_coder_projects__project_name__delete","parameters":[{"name":"project_name","in":"path","required":true,"schema":{"type":"string","title":"Project Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Delete Desktop Coder Project Api V1 Desktop Coder Projects  Project Name  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop/coder/projects/purchase-slot":{"post":{"tags":["desktop"],"summary":"Buy one additional Windows Desktop Coding Mode project slot from Token Wallet credit","operationId":"v1_purchase_desktop_coder_project_slot_api_v1_desktop_coder_projects_purchase_slot_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Purchase Desktop Coder Project Slot Api V1 Desktop Coder Projects Purchase Slot Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop/presence":{"post":{"tags":["desktop"],"summary":"Record a live Desktop Setup Client heartbeat","operationId":"v1_desktop_presence_api_v1_desktop_presence_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopPresenceBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Desktop Presence Api V1 Desktop Presence Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/desktop/bug-report":{"post":{"tags":["desktop"],"summary":"Send a customer desktop bug report to CodexAPI.pro support","operationId":"v1_desktop_bug_report_api_v1_desktop_bug_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopBugReportBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Desktop Bug Report Api V1 Desktop Bug Report Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/referral":{"get":{"tags":["billing"],"summary":"Read the current CodexAPI.pro VIP Referral Club and Cash Wallet status","operationId":"v1_referral_summary_api_v1_referral_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Referral Summary Api V1 Referral Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/email":{"post":{"tags":["auth"],"summary":"Save the required customer email address for the current CodexAPI.pro wallet","operationId":"v1_chatplus_update_email_api_v1_me_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusEmailBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Update Email Api V1 Me Email Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/profile-name":{"post":{"tags":["auth"],"summary":"Save the customer profile first name and surname","operationId":"v1_chatplus_update_profile_name_api_v1_me_profile_name_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusProfileNameBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Update Profile Name Api V1 Me Profile Name Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/profile-name/dismiss":{"post":{"tags":["auth"],"summary":"Record that the customer skipped the profile name modal","operationId":"v1_chatplus_dismiss_profile_name_api_v1_me_profile_name_dismiss_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Dismiss Profile Name Api V1 Me Profile Name Dismiss Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/password":{"post":{"tags":["auth"],"summary":"Change the current CodexAPI.pro dashboard password","operationId":"v1_chatplus_update_password_api_v1_me_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiUserPasswordBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Update Password Api V1 Me Password Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/2fa/setup":{"post":{"tags":["auth"],"summary":"Start Google Authenticator 2FA setup for the current dashboard user","operationId":"v1_chatplus_two_factor_setup_api_v1_me_2fa_setup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Two Factor Setup Api V1 Me 2Fa Setup Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/2fa/enable":{"post":{"tags":["auth"],"summary":"Enable Google Authenticator 2FA after verifying the setup code","operationId":"v1_chatplus_two_factor_enable_api_v1_me_2fa_enable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusTwoFactorEnableBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Two Factor Enable Api V1 Me 2Fa Enable Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/2fa/disable":{"post":{"tags":["auth"],"summary":"Disable Google Authenticator 2FA for the current dashboard user","operationId":"v1_chatplus_two_factor_disable_api_v1_me_2fa_disable_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Two Factor Disable Api V1 Me 2Fa Disable Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/me/api-token/rotate":{"post":{"tags":["auth"],"summary":"Rotate the current customer's Codex API username/token once every 24 hours","operationId":"v1_chatplus_rotate_api_token_api_v1_me_api_token_rotate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusApiTokenRotateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Rotate Api Token Api V1 Me Api Token Rotate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/telegram/webhook":{"post":{"tags":["auth"],"summary":"Receive Telegram Bot API webhook updates for dashboard actions","operationId":"v1_telegram_webhook_api_v1_telegram_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Telegram Webhook Api V1 Telegram Webhook Post"}}}}}}},"/api/v1/telegram/google/start":{"get":{"tags":["auth"],"summary":"Start Google sign-in for linking an existing CodexAPI.pro account to Telegram","operationId":"v1_telegram_google_start_api_v1_telegram_google_start_get","parameters":[{"name":"chatId","in":"query","required":true,"schema":{"type":"string","title":"Chatid"}},{"name":"telegramUserId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telegramuserid"}},{"name":"telegramUsername","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telegramusername"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/telegram/google/callback":{"get":{"tags":["auth"],"summary":"Complete Telegram Google account linking","operationId":"v1_telegram_google_callback_api_v1_telegram_google_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/billing/token-usage":{"get":{"tags":["billing"],"summary":"Read token usage transactions and daily spend for the current wallet","operationId":"v1_chatplus_token_usage_api_v1_billing_token_usage_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":180,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus Token Usage Api V1 Billing Token Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/daily-checkin":{"get":{"tags":["billing"],"summary":"Read the current wallet's Daily Check-in reward status","operationId":"v1_chatplus_daily_checkin_api_v1_daily_checkin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Daily Checkin Api V1 Daily Checkin Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/raffle":{"get":{"tags":["billing"],"summary":"Read the current wallet's worldwide coding raffle status","operationId":"v1_chatplus_raffle_api_v1_raffle_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Raffle Api V1 Raffle Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/daily-checkin/claim":{"post":{"tags":["billing"],"summary":"Claim today's Daily Check-in wallet reward","operationId":"v1_chatplus_claim_daily_checkin_api_v1_daily_checkin_claim_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Claim Daily Checkin Api V1 Daily Checkin Claim Post"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/share-credit":{"get":{"tags":["billing"],"summary":"Read the one-time CodexAPI.pro share-credit offer for the current wallet","operationId":"v1_chatplus_share_credit_api_v1_share_credit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Share Credit Api V1 Share Credit Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/share-credit/claim":{"post":{"tags":["billing"],"summary":"Claim the one-time CodexAPI.pro share credit after sharing the public site","operationId":"v1_chatplus_claim_share_credit_api_v1_share_credit_claim_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ChatPlusShareCreditClaimBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Claim Share Credit Api V1 Share Credit Claim Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/cash-wallet/stripe/checkout":{"post":{"tags":["billing"],"summary":"Create a Stripe Checkout Session to load real-money Cash Wallet balance","operationId":"v1_cash_wallet_stripe_checkout_api_v1_cash_wallet_stripe_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusCashWalletCheckoutBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Cash Wallet Stripe Checkout Api V1 Cash Wallet Stripe Checkout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/cash-wallet/paymento/checkout":{"post":{"tags":["billing"],"summary":"Create a Paymento crypto checkout to load real-money Cash Wallet balance","operationId":"v1_cash_wallet_paymento_checkout_api_v1_cash_wallet_paymento_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusCashWalletCheckoutBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Cash Wallet Paymento Checkout Api V1 Cash Wallet Paymento Checkout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/cash-wallet/stripe/confirm":{"post":{"tags":["billing"],"summary":"Confirm a paid Stripe Checkout Session and reconcile Cash Wallet balance","operationId":"v1_cash_wallet_stripe_confirm_api_v1_cash_wallet_stripe_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusStripeConfirmBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Cash Wallet Stripe Confirm Api V1 Cash Wallet Stripe Confirm Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/cash-wallet/token-purchase":{"post":{"tags":["billing"],"summary":"Use Cash Wallet balance to buy a Token Wallet top-up package","operationId":"v1_cash_wallet_token_purchase_api_v1_cash_wallet_token_purchase_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusCashWalletTokenPurchaseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Cash Wallet Token Purchase Api V1 Cash Wallet Token Purchase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/cash-wallet/unlimited-purchase":{"post":{"tags":["billing"],"summary":"Use Cash Wallet balance to buy an Unlimited Coding plan","operationId":"v1_cash_wallet_unlimited_purchase_api_v1_cash_wallet_unlimited_purchase_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusCashWalletUnlimitedPurchaseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Cash Wallet Unlimited Purchase Api V1 Cash Wallet Unlimited Purchase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/topup-discount":{"post":{"tags":["billing"],"summary":"Validate a user-scoped top-up bonus code","operationId":"v1_chatplus_topup_discount_api_v1_wallet_topup_discount_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusTopupDiscountBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Topup Discount Api V1 Wallet Topup Discount Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/topupemail-session-discount":{"post":{"tags":["billing"],"summary":"Issue a time-boxed top-up email discount","operationId":"v1_chatplus_topupemail_session_discount_api_v1_wallet_topupemail_session_discount_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ChatPlusTopupSessionDiscountBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Topupemail Session Discount Api V1 Wallet Topupemail Session Discount Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/unlimited-coding/plans":{"get":{"tags":["billing"],"summary":"List currently available Unlimited Coding plans","operationId":"v1_limited_unlimited_coding_plans_api_v1_unlimited_coding_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Limited Unlimited Coding Plans Api V1 Unlimited Coding Plans Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/paymento/checkout":{"post":{"tags":["billing"],"summary":"Create a crypto checkout","operationId":"v1_chatplus_paymento_checkout_api_v1_wallet_paymento_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusStripeCheckoutBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Paymento Checkout Api V1 Wallet Paymento Checkout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/paymento/options":{"get":{"tags":["billing"],"summary":"List crypto checkout options","operationId":"v1_chatplus_paymento_options_api_v1_wallet_paymento_options_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Paymento Options Api V1 Wallet Paymento Options Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/paymento/refund-addresses":{"get":{"tags":["billing"],"summary":"List saved refund addresses","operationId":"v1_chatplus_paymento_refund_addresses_api_v1_wallet_paymento_refund_addresses_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Paymento Refund Addresses Api V1 Wallet Paymento Refund Addresses Get"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["billing"],"summary":"Save a refund address","operationId":"v1_chatplus_paymento_save_refund_address_api_v1_wallet_paymento_refund_addresses_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentoRefundAddressBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Paymento Save Refund Address Api V1 Wallet Paymento Refund Addresses Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/paymento/refund-addresses/{address_id}":{"delete":{"tags":["billing"],"summary":"Delete a refund address","operationId":"v1_chatplus_paymento_delete_refund_address_api_v1_wallet_paymento_refund_addresses__address_id__delete","parameters":[{"name":"address_id","in":"path","required":true,"schema":{"type":"integer","title":"Address Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus Paymento Delete Refund Address Api V1 Wallet Paymento Refund Addresses  Address Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/paymento/orders/{order_id}":{"get":{"tags":["billing"],"summary":"Check a crypto order","operationId":"v1_chatplus_paymento_order_status_api_v1_wallet_paymento_orders__order_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Chatplus Paymento Order Status Api V1 Wallet Paymento Orders  Order Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/paymento/orders/{order_id}/receipt.pdf":{"get":{"tags":["billing"],"summary":"Download a customer-owned crypto payment receipt","operationId":"v1_chatplus_paymento_receipt_api_v1_wallet_paymento_orders__order_id__receipt_pdf_get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/stripe/checkout":{"post":{"tags":["billing"],"summary":"Create a Stripe Checkout Session for a CodexAPI.pro wallet credit pack","operationId":"v1_chatplus_stripe_checkout_api_v1_wallet_stripe_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusStripeCheckoutBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Stripe Checkout Api V1 Wallet Stripe Checkout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/stripe/confirm":{"post":{"tags":["billing"],"summary":"Confirm a paid Stripe Checkout Session and reconcile wallet credit","operationId":"v1_chatplus_stripe_confirm_api_v1_wallet_stripe_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusStripeConfirmBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Stripe Confirm Api V1 Wallet Stripe Confirm Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/wallet/auto-topup":{"post":{"tags":["billing"],"summary":"Configure automatic wallet top-up for the current CodexAPI.pro user","operationId":"v1_chatplus_auto_topup_api_v1_wallet_auto_topup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusAutoTopUpBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Auto Topup Api V1 Wallet Auto Topup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/stripe/webhook":{"post":{"tags":["billing"],"summary":"Receive Stripe wallet payment events","operationId":"v1_stripe_webhook_api_v1_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Stripe Webhook Api V1 Stripe Webhook Post"}}}}}}},"/api/v1/wallet/top-up":{"post":{"tags":["billing"],"summary":"Load credit onto the current CodexAPI.pro wallet after a plan payment","operationId":"v1_chatplus_wallet_top_up_api_v1_wallet_top_up_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPlusWalletTopUpBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Chatplus Wallet Top Up Api V1 Wallet Top Up Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/agent/status":{"get":{"tags":["agent"],"summary":"Read the managed Codex account state and default coding-agent configuration","operationId":"v1_agent_status_api_v1_agent_status_get","parameters":[{"name":"refresh_token","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Agent Status Api V1 Agent Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/permissions":{"get":{"tags":["agent"],"summary":"Read Codex permission profile presets for API clients","operationId":"v1_permissions_api_v1_permissions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Permissions Api V1 Permissions Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/skills":{"get":{"tags":["agent"],"summary":"List Codex skills available to API-backed Codex sessions","operationId":"v1_skills_api_v1_skills_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Skills Api V1 Skills Get"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects":{"get":{"tags":["projects"],"summary":"List managed isolated project workspaces","operationId":"v1_list_projects_api_v1_projects_get","parameters":[{"name":"ownerId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ownerid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 List Projects Api V1 Projects Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"post":{"tags":["projects"],"summary":"Create a managed project workspace for a web coding session","operationId":"v1_create_project_api_v1_projects_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManagedProjectCreateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Create Project Api V1 Projects Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}":{"get":{"tags":["projects"],"summary":"Read managed project metadata and its latest Codex thread summary","operationId":"v1_read_project_api_v1_projects__project_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Read Project Api V1 Projects  Project Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/state":{"get":{"tags":["agent"],"summary":"Read project metadata, latest thread state, and pending project-scoped approvals","operationId":"v1_project_state_api_v1_projects__project_id__state_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"includeTurns","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Includeturns"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Project State Api V1 Projects  Project Id  State Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/thread":{"get":{"tags":["agent"],"summary":"Read the latest Codex thread for a managed project","operationId":"v1_read_project_thread_api_v1_projects__project_id__thread_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"includeTurns","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Includeturns"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Read Project Thread Api V1 Projects  Project Id  Thread Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/open":{"post":{"tags":["agent"],"summary":"Open or resume a managed project and optionally start an initial turn","operationId":"v1_open_project_api_v1_projects__project_id__open_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManagedProjectRunBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Open Project Api V1 Projects  Project Id  Open Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/turns":{"post":{"tags":["agent"],"summary":"Start a project-scoped Codex turn using the web-coding defaults","operationId":"v1_project_turn_api_v1_projects__project_id__turns_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManagedProjectRunBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Project Turn Api V1 Projects  Project Id  Turns Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/turns/{turn_id}/interrupt":{"post":{"tags":["agent"],"summary":"Interrupt an active turn for a managed project","operationId":"v1_project_turn_interrupt_api_v1_projects__project_id__turns__turn_id__interrupt_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"turn_id","in":"path","required":true,"schema":{"type":"string","title":"Turn Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Project Turn Interrupt Api V1 Projects  Project Id  Turns  Turn Id  Interrupt Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/approvals":{"get":{"tags":["agent"],"summary":"List pending approval requests for the latest managed project thread","operationId":"v1_project_approvals_api_v1_projects__project_id__approvals_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Project Approvals Api V1 Projects  Project Id  Approvals Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/approvals/{request_id}/resolve":{"post":{"tags":["agent"],"summary":"Resolve a pending project-scoped approval request","operationId":"v1_resolve_project_approval_api_v1_projects__project_id__approvals__request_id__resolve_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"request_id","in":"path","required":true,"schema":{"type":"integer","title":"Request Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveServerRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Resolve Project Approval Api V1 Projects  Project Id  Approvals  Request Id  Resolve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/events":{"get":{"tags":["agent"],"summary":"Stream project-scoped Codex notifications over SSE","operationId":"v1_project_events_api_v1_projects__project_id__events_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"threadId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Threadid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/files/tree":{"get":{"tags":["projects"],"summary":"List files inside a managed project workspace","operationId":"v1_project_file_tree_api_v1_projects__project_id__files_tree_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"}},{"name":"recursive","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Recursive"}},{"name":"includeHidden","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Includehidden"}},{"name":"maxEntries","in":"query","required":false,"schema":{"type":"integer","default":500,"title":"Maxentries"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Project File Tree Api V1 Projects  Project Id  Files Tree Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/v1/projects/{project_id}/files/content":{"get":{"tags":["projects"],"summary":"Read a file from a managed project workspace","operationId":"v1_project_file_content_api_v1_projects__project_id__files_content_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"path","in":"query","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Project File Content Api V1 Projects  Project Id  Files Content Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]},"put":{"tags":["projects"],"summary":"Write a file inside a managed project workspace","operationId":"v1_write_project_file_api_v1_projects__project_id__files_content_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManagedProjectFileWriteBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Write Project File Api V1 Projects  Project Id  Files Content Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiBearer":[]}]}},"/api/core/releases/current":{"get":{"tags":["releases"],"summary":"Read the current synced stable Codex release","operationId":"current_release_api_core_releases_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Current Release Api Core Releases Current Get"}}}}},"security":[{"ApiBearer":[]}]}}},"components":{"schemas":{"AdminApiKeyCreateBody":{"properties":{"name":{"type":"string","title":"Name","description":"Display name for the admin-only API key."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional note describing the admin service using this key."},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expiresat","description":"Optional ISO-8601 expiry timestamp in UTC."},"manualToken":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Manualtoken","description":"Optional admin-supplied bearer token. Leave empty to generate a cxadm token."}},"type":"object","required":["name"],"title":"AdminApiKeyCreateBody"},"AdminRpcBody":{"properties":{"method":{"type":"string","title":"Method"},"params":{"additionalProperties":true,"type":"object","title":"Params"},"timeout_seconds":{"type":"number","title":"Timeout Seconds","default":60.0}},"type":"object","required":["method"],"title":"AdminRpcBody"},"ApiUserPasswordBody":{"properties":{"password":{"type":"string","title":"Password"},"confirmPassword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confirmpassword"}},"type":"object","required":["password"],"title":"ApiUserPasswordBody"},"ChatPlusApiTokenRotateBody":{"properties":{"confirm":{"type":"boolean","title":"Confirm","default":true}},"type":"object","title":"ChatPlusApiTokenRotateBody"},"ChatPlusAutoTopUpBody":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"thresholdUsd":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Thresholdusd","default":"10.00"},"planId":{"type":"string","title":"Planid","default":"starter"}},"type":"object","title":"ChatPlusAutoTopUpBody"},"ChatPlusCashWalletCheckoutBody":{"properties":{"amountUsd":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Amountusd"},"returnTo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Returnto"}},"type":"object","required":["amountUsd"],"title":"ChatPlusCashWalletCheckoutBody"},"ChatPlusCashWalletTokenPurchaseBody":{"properties":{"planId":{"type":"string","title":"Planid"},"amountUsd":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amountusd"}},"type":"object","required":["planId"],"title":"ChatPlusCashWalletTokenPurchaseBody"},"ChatPlusCashWalletUnlimitedPurchaseBody":{"properties":{"planId":{"type":"string","title":"Planid"},"pauseTime":{"type":"boolean","title":"Pausetime","default":false},"requestId":{"type":"string","maxLength":120,"title":"Requestid","default":""}},"type":"object","required":["planId"],"title":"ChatPlusCashWalletUnlimitedPurchaseBody"},"ChatPlusEmailBody":{"properties":{"email":{"type":"string","title":"Email"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"confirmPassword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confirmpassword"},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"}},"type":"object","required":["email"],"title":"ChatPlusEmailBody"},"ChatPlusLoginBody":{"properties":{"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"},"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Devicename"},"deviceFingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Devicefingerprint"},"deviceMetadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Devicemetadata"}},"type":"object","required":["username","password"],"title":"ChatPlusLoginBody"},"ChatPlusProfileNameBody":{"properties":{"firstName":{"type":"string","title":"Firstname"},"lastName":{"type":"string","title":"Lastname"}},"type":"object","required":["firstName","lastName"],"title":"ChatPlusProfileNameBody"},"ChatPlusRegisterBody":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"planId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Planid"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname"},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Countrycode"},"countryName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Countryname"},"mobileNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobilenumber"},"deviceFingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Devicefingerprint"},"deviceMetadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Devicemetadata"},"referralCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referralcode"},"humanCheckId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Humancheckid"},"humanCheckAnswer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Humancheckanswer"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"}},"type":"object","title":"ChatPlusRegisterBody"},"ChatPlusShareCreditClaimBody":{"properties":{"shareUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shareurl"}},"type":"object","title":"ChatPlusShareCreditClaimBody"},"ChatPlusStripeCheckoutBody":{"properties":{"planId":{"type":"string","title":"Planid"},"pauseTime":{"type":"boolean","title":"Pausetime","default":false},"autoRenewPlanId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Autorenewplanid"},"autoRenewPause":{"type":"boolean","title":"Autorenewpause","default":false},"returnTo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Returnto"},"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quantity","default":1},"amountUsd":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amountusd"},"discountCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discountcode"}},"type":"object","required":["planId"],"title":"ChatPlusStripeCheckoutBody"},"ChatPlusStripeConfirmBody":{"properties":{"sessionId":{"type":"string","title":"Sessionid"}},"type":"object","required":["sessionId"],"title":"ChatPlusStripeConfirmBody"},"ChatPlusTopupDiscountBody":{"properties":{"discountCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discountcode"}},"type":"object","title":"ChatPlusTopupDiscountBody"},"ChatPlusTopupSessionDiscountBody":{"properties":{"campaignKey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaignkey"}},"type":"object","title":"ChatPlusTopupSessionDiscountBody"},"ChatPlusTwoFactorEnableBody":{"properties":{"code":{"type":"string","title":"Code"}},"type":"object","required":["code"],"title":"ChatPlusTwoFactorEnableBody"},"ChatPlusTwoFactorVerifyBody":{"properties":{"challengeToken":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Challengetoken"},"code":{"type":"string","title":"Code"},"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Devicename"},"deviceFingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Devicefingerprint"},"deviceMetadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Devicemetadata"}},"type":"object","required":["code"],"title":"ChatPlusTwoFactorVerifyBody"},"ChatPlusWalletTopUpBody":{"properties":{"planId":{"type":"string","title":"Planid"},"paymentMethod":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paymentmethod","default":"sandbox"}},"type":"object","required":["planId"],"title":"ChatPlusWalletTopUpBody"},"ClaudeProviderHealthSettingsBody":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":true},"intervalSeconds":{"type":"integer","title":"Intervalseconds","default":600},"retries":{"type":"integer","title":"Retries","default":3},"timeoutSeconds":{"type":"integer","title":"Timeoutseconds","default":20},"model":{"type":"string","title":"Model","default":"claude-opus-5"},"targets":{"items":{"$ref":"#/components/schemas/ClaudeProviderHealthTargetBody"},"type":"array","title":"Targets"}},"type":"object","title":"ClaudeProviderHealthSettingsBody"},"ClaudeProviderHealthTargetBody":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"baseUrl":{"type":"string","title":"Baseurl"},"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","required":["id","label","baseUrl"],"title":"ClaudeProviderHealthTargetBody"},"CustomerEngagementPreferencesBody":{"properties":{"browserNotificationsEnabled":{"type":"boolean","title":"Browsernotificationsenabled","default":false},"dailyReminderEnabled":{"type":"boolean","title":"Dailyreminderenabled","default":true},"dailyReminderTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","title":"Dailyremindertime","default":"08:00"},"timezone":{"type":"string","maxLength":80,"minLength":1,"title":"Timezone","default":"UTC"},"promotionEmailsEnabled":{"type":"boolean","title":"Promotionemailsenabled","default":true},"reducedMotionEnabled":{"type":"boolean","title":"Reducedmotionenabled","default":false},"welcomeBackRemindersEnabled":{"type":"boolean","title":"Welcomebackremindersenabled","default":true},"welcomeBackReminderLeadHours":{"type":"integer","title":"Welcomebackreminderleadhours","default":72},"welcomeBackEmailFrequency":{"type":"string","title":"Welcomebackemailfrequency","default":"important"}},"type":"object","title":"CustomerEngagementPreferencesBody"},"DashboardSsoLinkBody":{"properties":{"returnTo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Returnto"},"purpose":{"type":"string","title":"Purpose","default":"dashboard"}},"type":"object","title":"DashboardSsoLinkBody"},"DesktopAdminPushBody":{"properties":{"title":{"type":"string","title":"Title"},"body":{"type":"string","title":"Body"},"audience":{"type":"string","enum":["public","private"],"title":"Audience","default":"private"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"actionUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actionurl"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imageurl"}},"type":"object","required":["title","body"],"title":"DesktopAdminPushBody"},"DesktopBugReportBody":{"properties":{"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"message":{"type":"string","title":"Message"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Appversion"},"diagnostics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Diagnostics"}},"type":"object","required":["message"],"title":"DesktopBugReportBody"},"DesktopChatConversationCreateBody":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"modelId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modelid"}},"type":"object","title":"DesktopChatConversationCreateBody"},"DesktopChatPromptBody":{"properties":{"content":{"type":"string","title":"Content","default":""},"modelId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modelid"},"attachments":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Attachments"},"webBrowsing":{"type":"boolean","title":"Webbrowsing","default":true},"mode":{"type":"string","title":"Mode","default":"chat"}},"type":"object","title":"DesktopChatPromptBody"},"DesktopCoderDatabaseBody":{"properties":{"host":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Host"},"port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Port"},"databaseName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databasename"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"sslmode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sslmode","default":"disable"}},"type":"object","title":"DesktopCoderDatabaseBody"},"DesktopCoderProjectBody":{"properties":{"projectName":{"type":"string","title":"Projectname"},"modelId":{"type":"string","title":"Modelid","default":"gpt-5.6"},"workingDirectory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workingdirectory","default":""},"selectedRegion":{"type":"string","title":"Selectedregion","default":"canada"},"customDatabase":{"anyOf":[{"$ref":"#/components/schemas/DesktopCoderDatabaseBody"},{"type":"null"}]}},"type":"object","required":["projectName"],"title":"DesktopCoderProjectBody"},"DesktopCodingSessionBody":{"properties":{"sessionKey":{"type":"string","title":"Sessionkey","default":"desktop-default"},"modelId":{"type":"string","title":"Modelid","default":"gpt-5.6"},"workingDirectory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workingdirectory","default":""},"history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"History"},"compactedSummary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compactedsummary","default":""},"approxTokenCount":{"type":"integer","title":"Approxtokencount","default":0},"contextWindowTokens":{"type":"integer","title":"Contextwindowtokens","default":272000},"autoCompactTokenLimit":{"type":"integer","title":"Autocompacttokenlimit","default":244800},"compactionCount":{"type":"integer","title":"Compactioncount","default":0},"lastResponseId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastresponseid","default":""}},"type":"object","title":"DesktopCodingSessionBody"},"DesktopPresenceBody":{"properties":{"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Appversion","default":""},"apiBaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apibaseurl","default":""},"selectedRegion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selectedregion","default":""},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hostname"}},"type":"object","title":"DesktopPresenceBody"},"DesktopShoutboxMessageBody":{"properties":{"content":{"type":"string","title":"Content","default":""}},"type":"object","title":"DesktopShoutboxMessageBody"},"DesktopShoutboxProfileBody":{"properties":{"username":{"type":"string","title":"Username"}},"type":"object","required":["username"],"title":"DesktopShoutboxProfileBody"},"DeviceLoginRequest":{"properties":{"force_refresh_status":{"type":"boolean","title":"Force Refresh Status","default":false}},"type":"object","title":"DeviceLoginRequest"},"DiscordVipGrantBody":{"properties":{"username":{"type":"string","title":"Username"},"days":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Days","default":5},"discordUserId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discorduserid"}},"type":"object","required":["username"],"title":"DiscordVipGrantBody"},"GumroadRegisterBody":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"password":{"type":"string","title":"Password"},"email":{"type":"string","title":"Email"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname"},"deviceFingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Devicefingerprint"},"deviceMetadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Devicemetadata"},"referralCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referralcode"},"humanCheckId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Humancheckid"},"humanCheckAnswer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Humancheckanswer"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"}},"type":"object","required":["password","email"],"title":"GumroadRegisterBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MaintenanceModeBody":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":true},"durationMinutes":{"type":"integer","title":"Durationminutes","default":30},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","title":"MaintenanceModeBody"},"ManageModelsSettingsBody":{"properties":{"powerAiTarget":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Poweraitarget"},"codexMode":{"type":"string","title":"Codexmode","default":"logged_in_account"},"codexProvider":{"type":"string","title":"Codexprovider","default":"oneprovider"},"codexAccountId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codexaccountid"},"claudeMode":{"type":"string","title":"Claudemode","default":"logged_in_account"},"claudeProvider":{"type":"string","title":"Claudeprovider","default":"signed_in_gateway"},"claudeModel":{"type":"string","title":"Claudemodel","default":"claude-sonnet-5"},"crossModelRoute":{"type":"string","title":"Crossmodelroute","default":"none"},"fable5Route":{"type":"string","title":"Fable5Route","default":"opus48"},"astraRoute":{"type":"string","title":"Astraroute","default":"signed_in_session"},"codexSignedInModel":{"type":"string","title":"Codexsignedinmodel","default":"gpt-5.6-terra"},"codexReasoningEffort":{"type":"string","title":"Codexreasoningeffort","default":"xhigh"},"codexScheduleAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codexscheduleat"},"codexScheduleModel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codexschedulemodel"},"codexScheduleEffort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codexscheduleeffort"}},"type":"object","title":"ManageModelsSettingsBody"},"ManagedProjectCreateBody":{"properties":{"projectId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Projectid","description":"Optional stable project id. If omitted, the server generates one."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Human-friendly project name shown in the web coding UI."},"ownerId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ownerid","description":"Optional external user or account id that owns the project."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional brief describing the project goal."},"template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template","description":"Optional template label such as react, nextjs, or static-html."}},"type":"object","title":"ManagedProjectCreateBody"},"ManagedProjectFileWriteBody":{"properties":{"path":{"type":"string","title":"Path","description":"Relative file path within the managed project workspace."},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","description":"UTF-8 text content to write."},"contentBase64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contentbase64","description":"Binary content to write, encoded as base64."},"makeDirs":{"type":"boolean","title":"Makedirs","description":"Create missing parent directories before writing the file.","default":true}},"type":"object","required":["path"],"title":"ManagedProjectFileWriteBody"},"ManagedProjectRunBody":{"properties":{"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt","description":"Primary natural-language instruction for Codex."},"input":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Input","description":"Optional low-level Codex input items instead of a plain prompt."},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Override the default model. Defaults to gpt-5.6."},"effort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effort","description":"Override reasoning effort. Defaults to medium."},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"Optional turn summary mode or text."},"personality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personality","description":"Optional Codex personality override."},"approvalPolicy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalpolicy","description":"Codex approval policy override. Defaults to never for Full Access runs."},"approvalsReviewer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalsreviewer","description":"Optional upstream Codex approvals reviewer override, such as user or auto_review."},"sandboxPolicy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sandboxpolicy","description":"Optional legacy Codex sandbox policy override. For Codex 0.135.0 and newer, prefer permissions for thread-level profile selection."},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions","description":"Optional Codex 0.135.0 permissions profile selection, for example {\"type\":\"profile\",\"id\":\":workspace\"}. If set, sandboxPolicy is not sent."},"permissionProfile":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissionprofile","description":"Alias for permissions used by clients whose Full Access toggle now lives under /permissions."},"outputSchema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Outputschema","description":"Optional JSON schema for the model's final response."}},"type":"object","title":"ManagedProjectRunBody"},"ModelHealthTestBody":{"properties":{"model":{"type":"string","title":"Model","default":"claude-opus-5"},"retries":{"type":"integer","title":"Retries","default":0},"timeoutSeconds":{"type":"integer","title":"Timeoutseconds","default":20}},"type":"object","title":"ModelHealthTestBody"},"PasswordResetConfirmBody":{"properties":{"token":{"type":"string","title":"Token"},"password":{"type":"string","title":"Password"},"confirmPassword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confirmpassword"}},"type":"object","required":["token","password"],"title":"PasswordResetConfirmBody"},"PasswordResetRequestBody":{"properties":{"identifier":{"type":"string","title":"Identifier"},"origin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Origin"}},"type":"object","required":["identifier"],"title":"PasswordResetRequestBody"},"PaymentoRefundAddressBody":{"properties":{"coinSymbol":{"type":"string","maxLength":20,"minLength":2,"title":"Coinsymbol"},"network":{"type":"string","maxLength":40,"minLength":2,"title":"Network"},"address":{"type":"string","maxLength":200,"minLength":12,"title":"Address"},"label":{"type":"string","maxLength":80,"title":"Label","default":""},"isDefault":{"type":"boolean","title":"Isdefault","default":false}},"type":"object","required":["coinSymbol","network","address"],"title":"PaymentoRefundAddressBody"},"ProjectOpenBody":{"properties":{"cwd":{"type":"string","title":"Cwd"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"effort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effort"},"personality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personality"},"approvalPolicy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalpolicy"},"approvalsReviewer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalsreviewer"},"sandboxPolicy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sandboxpolicy"},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions"},"permissionProfile":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissionprofile"}},"type":"object","required":["cwd"],"title":"ProjectOpenBody"},"PurchasePreferencesBody":{"properties":{"preferredPlanId":{"type":"string","title":"Preferredplanid","default":"test"},"lowBalanceNotificationsEnabled":{"type":"boolean","title":"Lowbalancenotificationsenabled","default":true},"lowBalanceThresholdUsd":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Lowbalancethresholdusd","default":"15.00"},"invoiceBusinessName":{"type":"string","title":"Invoicebusinessname","default":""},"invoiceTaxId":{"type":"string","title":"Invoicetaxid","default":""},"invoiceEmail":{"type":"string","title":"Invoiceemail","default":""},"invoiceAddressLine1":{"type":"string","title":"Invoiceaddressline1","default":""},"invoiceAddressLine2":{"type":"string","title":"Invoiceaddressline2","default":""},"invoiceCity":{"type":"string","title":"Invoicecity","default":""},"invoiceRegion":{"type":"string","title":"Invoiceregion","default":""},"invoicePostalCode":{"type":"string","title":"Invoicepostalcode","default":""},"invoiceCountryCode":{"type":"string","title":"Invoicecountrycode","default":""}},"type":"object","title":"PurchasePreferencesBody"},"RedditConversionBody":{"properties":{"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"},"screenWidth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Screenwidth"},"screenHeight":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Screenheight"}},"type":"object","title":"RedditConversionBody"},"ResolveServerRequestBody":{"properties":{"decision":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Decision","description":"Approval decision for known request types. For current Codex v2 item approvals, use values like `accept`, `acceptForSession`, `decline`, or `cancel`."},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions","description":"Granted permission subset for `item/permissions/requestApproval`."},"scope":{"anyOf":[{"type":"string","enum":["turn","session"]},{"type":"null"}],"title":"Scope","description":"Grant scope for `item/permissions/requestApproval`."},"strictAutoReview":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Strictautoreview","description":"Optional strict auto-review toggle for `item/permissions/requestApproval`."},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"}},"type":"object","title":"ResolveServerRequestBody"},"RpcCallRequest":{"properties":{"method":{"type":"string","title":"Method"},"params":{"additionalProperties":true,"type":"object","title":"Params"},"timeout_seconds":{"type":"number","title":"Timeout Seconds","default":60.0}},"type":"object","required":["method"],"title":"RpcCallRequest"},"RpcNotifyRequest":{"properties":{"method":{"type":"string","title":"Method"},"params":{"additionalProperties":true,"type":"object","title":"Params"}},"type":"object","required":["method"],"title":"RpcNotifyRequest"},"ThreadStartBody":{"properties":{"cwd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cwd"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"personality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personality"},"approvalPolicy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalpolicy"},"approvalsReviewer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalsreviewer"},"sandboxPolicy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sandboxpolicy"},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions"},"permissionProfile":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissionprofile"}},"type":"object","title":"ThreadStartBody"},"TokenRatePercentAdjustmentBody":{"properties":{"percent":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Percent","description":"Percentage adjustment. Use 20 to increase by 20%, -20 to decrease by 20%."},"serviceIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Serviceids"}},"type":"object","required":["percent"],"title":"TokenRatePercentAdjustmentBody"},"ToolboxSettingsBody":{"properties":{"surgePricingAction":{"type":"string","title":"Surgepricingaction","default":"standard"},"gatewayPolicyMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gatewaypolicymode"},"responseLanguage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Responselanguage"}},"type":"object","title":"ToolboxSettingsBody"},"TurnStartBody":{"properties":{"threadId":{"type":"string","title":"Threadid"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"input":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Input"},"cwd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cwd"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"effort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effort"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"personality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personality"},"approvalPolicy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalpolicy"},"approvalsReviewer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approvalsreviewer"},"sandboxPolicy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sandboxpolicy"},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions"},"permissionProfile":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissionprofile"},"outputSchema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Outputschema"}},"type":"object","required":["threadId"],"title":"TurnStartBody"},"UserApiKeyCreateBody":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name","description":"Customer-visible label for this wallet-linked API key.","default":"User API Key"},"description":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Description","description":"Optional note for where this key is used."},"expiresAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expiresat"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"spendingLimitUsd":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Spendinglimitusd"},"usageNotificationPercent":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Usagenotificationpercent"},"allowedIps":{"items":{"type":"string"},"type":"array","title":"Allowedips"}},"type":"object","title":"UserApiKeyCreateBody"},"UserApiKeyUpdateBody":{"properties":{"applicationLabel":{"anyOf":[{"type":"string","maxLength":80,"minLength":1},{"type":"null"}],"title":"Applicationlabel"},"expiresAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expiresat"},"clearExpiration":{"type":"boolean","title":"Clearexpiration","default":false},"permissions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Permissions"},"spendingLimitUsd":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Spendinglimitusd"},"clearSpendingLimit":{"type":"boolean","title":"Clearspendinglimit","default":false},"usageNotificationPercent":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Usagenotificationpercent"},"clearUsageNotification":{"type":"boolean","title":"Clearusagenotification","default":false},"allowedIps":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowedips"}},"type":"object","title":"UserApiKeyUpdateBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiBearer":{"type":"http","scheme":"bearer","bearerFormat":"Codex API username or API token","description":"Bearer token for standard API operations. Accepts either the static `CODEX_API_TOKEN` value or any active PostgreSQL-backed API key with `accessLevel=api` created from the admin dashboard. For wallet-linked client calls, the customer's Codex API username also works as the bearer value and is billed against that user's active wallet key."}}},"tags":[{"name":"system","description":"Process lifecycle and runtime status."},{"name":"rpc","description":"Direct Codex app-server RPC access and streaming events."},{"name":"auth","description":"Authentication and account state, including ChatGPT device login."},{"name":"threads","description":"Thread and project history operations."},{"name":"turns","description":"Turn execution and interruption."},{"name":"projects","description":"Managed isolated project workspaces and file access."},{"name":"agent","description":"Stable v1 project-scoped agent orchestration endpoints for web coding clients."},{"name":"openai-compatible","description":"OpenAI Responses-compatible gateway for stock public Codex CLI clients."},{"name":"releases","description":"Stable upstream Codex release tracking."}]}