Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Codai Ro Session API
version: '1'
description: 'Operations tagged Session across 2 of this provider''s published API definitions: codai-ro-auth-openapi.json, codai-ro-auth-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://auth.codai.ro
description: Production
security: []
tags:
- name: Session
description: RP-initiated logout (OpenID Connect RP-Initiated Logout 1.0).
paths:
/session/end:
get:
operationId: endSession
tags:
- Session
summary: RP-initiated logout
description: 'Ends the user''s codai browser session. Renders a confirmation page (unless the
`id_token_hint` identifies the session unambiguously), then fans out back-channel
logout tokens to every client with a `backchannel_logout_uri`, and finally redirects to
`post_logout_redirect_uri` (must be registered on the client) with `state`, or shows a
"signed out" page when no redirect was given.'
parameters:
- name: id_token_hint
in: query
required: false
description: The ID token previously issued to this client; identifies the session and client.
schema:
type: string
- name: post_logout_redirect_uri
in: query
required: false
description: Registered post-logout redirect URI of the client.
schema:
type: string
format: uri
- name: state
in: query
required: false
description: Opaque value appended to the post-logout redirect.
schema:
type: string
- name: client_id
in: query
required: false
description: Required when `id_token_hint` is absent and a `post_logout_redirect_uri` is given.
schema:
type: string
- name: ui_locales
in: query
required: false
description: Standard OIDC parameter; the codai UI reads `?lang=ro|en` instead.
schema:
type: string
responses:
'200':
description: Logout confirmation page (or "signed out" page).
content:
text/html:
schema:
type: string
'303':
description: Redirect to `post_logout_redirect_uri` (+ `state`).
headers:
Location:
schema:
type: string
format: uri
'400':
description: Invalid `id_token_hint` / unregistered redirect URI, rendered as an HTML error page.
content:
text/html:
schema:
type: string
servers:
- url: https://auth.codai.ro
description: Production
components:
securitySchemes:
oauth2:
type: oauth2
description: codai OpenID Connect provider. PKCE `S256` required on the authorization code flow.
flows:
authorizationCode:
authorizationUrl: https://auth.codai.ro/auth
tokenUrl: https://auth.codai.ro/token
refreshUrl: https://auth.codai.ro/token
scopes:
openid: Verify your codai identity
profile: See your name and profile picture
email: See your email address
inference: Run AI inference through your codai account
keys:manage: Create and manage codai API keys on your behalf
usage:read: Read your codai usage statistics
subscriptions:read: Read your codai subscription plan
mcp: Use codai tools and memory from an MCP client
offline_access: Stay signed in on this device
deviceCode:
deviceAuthorizationUrl: https://auth.codai.ro/device/auth
tokenUrl: https://auth.codai.ro/token
scopes:
openid: Verify your codai identity
profile: See your name and profile picture
email: See your email address
inference: Run AI inference through your codai account
keys:manage: Create and manage codai API keys on your behalf
usage:read: Read your codai usage statistics
subscriptions:read: Read your codai subscription plan
mcp: Use codai tools and memory from an MCP client
offline_access: Stay signed in on this device
bearerAuth:
type: http
scheme: bearer
description: OAuth access token issued by `/token` (used by `/me` and `/connect/key`).
clientSecretBasic:
type: http
scheme: basic
description: '`client_secret_basic` client authentication. `client_secret_post` and `private_key_jwt` go in the form body instead; public clients send only `client_id`.'
x-refined-from:
- codai-ro-auth-openapi.json
- codai-ro-auth-openapi.yml