Reference

Generated Atlas contract registry

This page renders from the generated contract registry. Developer Console and public Atlas endpoints share one source of truth, so the reference stays aligned with the runtime.

GET/operator/developers/overviewimplementeddeveloper_console

Read Developer Console counts and granted permissions

Returns the owner-scoped Developer Console summary for the current Mirai organization.

Required permissions

  • developer_console.read

Required scopes

  • none
GET/operator/developers/appsimplementeddeveloper_console

List org-owned Atlas apps

Lists Atlas apps and registered redirect URIs for the active workspace.

Required permissions

  • atlas_api.apps.read

Required scopes

  • none
POST/operator/developers/appsimplementeddeveloper_console

Create an org-owned Atlas app

Creates a Developer Console app asset owned by the current organization.

Required permissions

  • atlas_api.apps.write

Required scopes

  • none
POST/operator/developers/apps/{appId}/redirect-urisimplementeddeveloper_console

Register an OAuth redirect URI

Adds a redirect URI to an existing org-owned Atlas app.

Required permissions

  • atlas_api.oauth.manage

Required scopes

  • none
POST/operator/developers/apps/{appId}/grantsimplementeddeveloper_console

Mint an app access grant

Creates an org-owned app bearer token for Atlas API access and returns the plaintext secret once.

Required permissions

  • atlas_api.oauth.manage

Required scopes

  • none
GET/operator/developers/service-accountsimplementeddeveloper_console

List service accounts and key metadata

Lists org-owned service accounts together with key prefixes and granted scope metadata.

Required permissions

  • atlas_api.service_accounts.manage

Required scopes

  • none
POST/operator/developers/service-accountsimplementeddeveloper_console

Create a service account

Creates an org-owned machine principal for Atlas API access.

Required permissions

  • atlas_api.service_accounts.manage

Required scopes

  • none
POST/operator/developers/service-accounts/{serviceAccountId}/keysimplementeddeveloper_console

Mint a service-account key

Creates a new scoped key and returns the plaintext secret exactly once.

Required permissions

  • atlas_api.keys.manage

Required scopes

  • none
GET/operator/developers/webhooksimplementeddeveloper_console

List webhook endpoints

Lists outbound webhook endpoints and subscribed event families.

Required permissions

  • atlas_api.webhooks.manage

Required scopes

  • none
POST/operator/developers/webhooksimplementeddeveloper_console

Create a webhook endpoint

Registers an outbound webhook endpoint and returns the signing secret once.

Required permissions

  • atlas_api.webhooks.manage

Required scopes

  • none
GET/operator/developers/audit-eventsimplementeddeveloper_console

List recent audit events

Returns the most recent Atlas developer asset lifecycle events for the org.

Required permissions

  • atlas_api.audit.read

Required scopes

  • none
GET/v1/atlas/channelsimplementedpublic_api

List connected Atlas channels

Returns connected business channels and health metadata for the active Atlas principal organization.

Required permissions

  • none

Required scopes

  • atlas.channels.read
GET/v1/atlas/knowledgeimplementedpublic_api

List Atlas Knowledge documents

Lists knowledge documents available to the active Atlas principal for shared RAG grounding.

Required permissions

  • none

Required scopes

  • atlas.knowledge.read
POST/v1/atlas/knowledgeimplementedpublic_api

Create Atlas Knowledge content

Creates a knowledge document through the canonical queued ingest path so status remains truthful until worker indexing completes.

Required permissions

  • none

Required scopes

  • atlas.knowledge.write
GET/v1/atlas/agentsimplementedpublic_api

List Atlas agents

Lists Atlas-hosted and external-agent records for the active organization.

Required permissions

  • none

Required scopes

  • atlas.agents.read
POST/v1/atlas/agentsimplementedpublic_api

Create an Atlas agent

Creates an agent and optionally links existing knowledge sources.

Required permissions

  • none

Required scopes

  • atlas.agents.write
GET/v1/atlas/sessionsimplementedpublic_api

List test sessions

Lists Atlas preview sessions for sandbox evaluation.

Required permissions

  • none

Required scopes

  • atlas.sessions.read
POST/v1/atlas/sessionsimplementedpublic_api

Create a test session

Creates a sandbox Atlas session tied to an optional agent.

Required permissions

  • none

Required scopes

  • atlas.sessions.write
GET/v1/atlas/sessions/{sessionId}/messagesimplementedpublic_api

List session messages

Returns the preview message transcript for a sandbox session.

Required permissions

  • none

Required scopes

  • atlas.sessions.read
POST/v1/atlas/sessions/{sessionId}/messagesimplementedpublic_api

Query a sandbox session

Adds a user message, runs keyword-backed Atlas Knowledge search, and returns a grounded preview reply.

Required permissions

  • none

Required scopes

  • atlas.sessions.write
GET/v1/atlas/conversationsimplementedpublic_api

List live conversations

Returns normalized omnichannel conversation summaries for the active organization.

Required permissions

  • none

Required scopes

  • atlas.conversations.read
POST/v1/atlas/eventsimplementedpublic_api

Receive inbound external-agent events

Accepts normalized inbound channel events, creates or updates the Mirai conversation, and emits signed outbound Atlas webhooks.

Required permissions

  • none

Required scopes

  • atlas.events.write
GET/v1/atlas/context/{conversationId}implementedpublic_api

Fetch customer, conversation, and knowledge context

Returns normalized conversation state, customer profile, recent messages, and grounded Atlas Knowledge search results.

Required permissions

  • none

Required scopes

  • atlas.context.read
POST/v1/atlas/actionsimplementedpublic_api

Submit an external-agent reply or action

Accepts replies, drafts, and handoff decisions, then routes reply delivery through Mirai-managed channels.

Required permissions

  • none

Required scopes

  • atlas.actions.execute
GET/v1/atlas/runsimplementedpublic_api

List Atlas runtime runs

Lists event and action runs recorded through the public Atlas API surface.

Required permissions

  • none

Required scopes

  • atlas.runs.read
GET/v1/atlas/webhooksimplementedpublic_api

List outbound Atlas webhook subscriptions

Lists webhook endpoints owned by the active app or service account principal.

Required permissions

  • none

Required scopes

  • atlas.events.read
POST/v1/atlas/webhooksimplementedpublic_api

Register outbound Atlas event delivery

Registers a signed outbound webhook endpoint for the active app or service account principal.

Required permissions

  • none

Required scopes

  • atlas.events.read