confcall OAuth Scopes

generated: '2026-11-04'
method: searched
source: https://docs.confcall.app/api-reference.html
schemes:
- name: OAuth2ClientCredentials
  source: openapi/confcall-app-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://auth.confcall.app/oauth/token
  description: 'OAuth 2.0 client-credentials grant. Exchange a client id/secret at
    the token URL for a short-lived bearer JWT and send it as `Authorization: Bearer
    <token>`. Operations with x-auth jwtOrApiKey accept either this or ApiKeyAuth;
    x-auth jwt operations need a user-context token.'
scopes:
- scope: confcall:history
  description: Read meeting artifacts (transcripts, summaries, action items)
  flows:
  - clientCredentials
  sources:
  - openapi/confcall-app-openapi.yml
  - https://docs.confcall.app/api-reference.html
  operations:
  - listRoomArtifacts
  - getArtifact
- scope: confcall:rooms
  description: Manage rooms and invite/remove the AI agent
  flows:
  - clientCredentials
  sources:
  - openapi/confcall-app-openapi.yml
  - https://docs.confcall.app/api-reference.html
  operations:
  - deleteRoom
  - inviteAiAgent
  - removeAiAgent
- scope: use:chat-agent
  description: Chat sessions (agent-widget JWT)
  flows: []
  token: short-lived JWT passed to <agent-widget> auth-token
  sources:
  - https://docs.confcall.app/agent-widget.html
- scope: use:voice-agent
  description: Voice calls (agent-widget JWT)
  flows: []
  token: short-lived JWT passed to <agent-widget> auth-token
  sources:
  - https://docs.confcall.app/agent-widget.html
- scope: read:ivr-config
  description: IVR config access (agent-widget JWT)
  flows: []
  token: short-lived JWT passed to <agent-widget> auth-token
  sources:
  - https://docs.confcall.app/agent-widget.html
docs: https://docs.confcall.app/api-reference.html
note: confcall:* scopes are declared in the OpenAPI and tagged per route on the API
  reference; use:*/read:* scopes are documented only for the <agent-widget> JWT (agent.confcall.app),
  not in the control-plane contract.