> ## Documentation Index > Fetch the complete documentation index at: https://docs.ravi.bot/llms.txt > Use this file to discover all available pages before exploring further. # conversations.open in the authorized private session store > Requires a signed Console delegation on the dedicated Console listener. Ordinary runtime context keys cannot invoke this operation. ## OpenAPI ````yaml /openapi.json post /api/v1/sessions/conversations/open openapi: 3.1.0 info: description: >- OpenAPI 3.1 spec auto-generated from the Ravi CLI registry. Each operation maps 1:1 to a `ravi ` invocation. title: Ravi API version: 8b8105209951c237 servers: - description: Local Ravi gateway (default) url: http://localhost:3000 security: [] tags: - description: Ask a Ravi Page's managers for access and follow the request name: access - description: Inspect session adapters and their debug snapshots name: adapters - description: >- The operator's calendar in the Ravi Console: meetings, recording and briefings name: agenda - description: Agent management name: agents - description: Discover and validate Ravi app manifests name: apps - description: Generic artifact ledger and lineage tools name: artifacts - description: Audio generation tools (TTS) name: audio - description: Typed project databases (Bases) in Ravi Console name: bases - description: Enroll the private Console human bridge name: bridge - description: Manage Ravi MCP bridges through Console name: bridges - description: File, comment on, and track global Ravi bug reports on Console name: bug - description: Manage local-first Ravi calendars name: calendars - description: Manage native Ravi channel runner name: channels - description: Inspect canonical chats, messages, and reading queues name: chats - name: cloud - description: Manage Ravi prompt commands name: commands - description: >- Connect and manage your own accounts (Gmail, Calendar, ...) through Ravi Console name: connectors - description: Contact management name: contacts - description: Runtime context registry and introspection name: context - description: Inspect token and cost tracking name: costs - name: credentials - description: CRM relationship surface name: crm - description: Scheduled job management name: cron - description: Manage ravi via PM2 name: daemon - description: Inspect ravi.db state (locks, WAL, holders) name: db - description: Explicit questions and immutable answers owned by tasks or threads name: decisions - name: devin - description: Run reproducible evaluation tasks against Ravi name: eval - description: Stream live NATS events name: events - description: Send structured feedback to Ravi Console name: feedback - description: >- Operate Gmail through a connected Google account (yours, the person asking's, or a shared one) name: gmail - description: Heartbeat scheduling management name: heartbeat - description: Generic runtime hooks name: hooks - description: Link chat people to their Ravi Console account name: identity - description: Image generation tools name: image - description: Local Ravi inbox and Console delivery compatibility commands name: inbox - description: Operational insights with explicit lineage name: insights - description: Instance management (channels, policies, routes) name: instances - description: Invite people into the Console organization by email name: invites - description: Execução de chamada longa em background, com desfecho entregue na sessão name: jobs - description: Search what the org said and published, with sources name: knowledge - description: Use local-first Ravi mail name: mail - description: Media sending name: media - description: Meeting artifact and provider operations name: meetings - description: Daily metrics rollup and reporting name: metrics - description: Inspect Observation Plane bindings name: observers - description: Manage project-owned Ravi Pages and publish content through Console name: pages - description: Inspect provider-runtime authorization name: permissions - description: Publish verified GitHub pull requests and reconcile CI follow name: pr - description: List and create the organization's projects in Ravi Console name: projects - name: prox - description: Emoji reactions name: react - description: Inspect route config and live routing without drilling into instances name: routes - description: Manage Ravi runtime prompt rules name: rules - name: runtime - description: Run one Ravi task in a disposable E2B cloud sandbox and collect its patch name: sandbox - name: sdk - description: Read the current Ravi agent/session/chat context name: self - description: Bot service management name: service - description: Manage agent sessions name: sessions - description: Global settings management name: settings - description: Durable world conditions with piggyback delivery name: signals - description: Manage runtime skill gate rules name: skill-gates - description: Skill discovery, install and inspection tools name: skills - description: Native Slack workspace operations name: slack - description: Versioned Ravi specs memory name: specs - description: Sticker library management and sending name: stickers - description: Local-first sync outbox, inbox, and Console bridge name: sync - description: Deterministic tag classification rules name: tag-rules - description: Unified tags for Ravi assets name: tags - description: Task runtime for dispatching work to Ravi agents name: tasks - description: >- Org and project themes in the Console Library: check, publish, propose and set the active theme name: themes - description: Manage Ravi threads name: threads - description: CLI tools inspection and export name: tools - description: Audio transcription name: transcribe - description: Event triggers name: triggers - description: Video analysis tools name: video - description: Create watches and wire their events to triggers name: watch - name: whatsapp - description: >- Widget templates in the Console Library: catalog, check, preview, publish and propose name: widgets - description: Resolve and mutate generic Work Objects through Ravi domain adapters name: work-objects - name: workflows - description: >- Operate YouTube Data API v3 and YouTube Analytics API v2 through Ravi credentials name: yt paths: /api/v1/sessions/conversations/open: post: tags: - sessions summary: conversations.open in the authorized private session store description: >- Requires a signed Console delegation on the dedicated Console listener. Ordinary runtime context keys cannot invoke this operation. operationId: sessions.conversations.open requestBody: content: application/json: schema: additionalProperties: false properties: conversationId: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string createdAt: exclusiveMinimum: 0 maximum: 9007199254740991 type: integer projectId: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string requestId: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string required: - projectId - requestId - createdAt - conversationId type: object required: true responses: '200': content: application/json: schema: additionalProperties: false properties: approvals: items: additionalProperties: false properties: actionDigest: type: string capability: additionalProperties: false properties: objectId: type: string objectType: type: string permission: type: string required: - permission - objectType - objectId type: object description: type: string expiresAt: type: number id: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string state: enum: - pending - approved - rejected - expired - invalidated type: string turnId: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string version: type: number required: - id - turnId - capability - description - actionDigest - version - expiresAt - state type: object type: array conversation: additionalProperties: false properties: agentId: type: string id: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string title: type: string updatedAt: type: number version: maximum: 9007199254740991 minimum: -9007199254740991 type: integer required: - id - agentId - title - version - updatedAt type: object cursor: type: string hasOlder: type: boolean messages: items: additionalProperties: false properties: createdAt: type: number id: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string role: enum: - user - assistant type: string text: type: string turnId: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string required: - id - role - text - turnId - createdAt type: object type: array turn: anyOf: - additionalProperties: false properties: cancelRequested: type: boolean id: format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string status: enum: - queued - running - awaiting_approval - completed - failed - cancelled - authorization_expired - interrupted_unknown type: string required: - id - status - cancelRequested type: object - type: 'null' required: - conversation - messages - hasOlder - cursor - turn - approvals type: object description: Success — body conforms to the `@Returns` schema. '400': description: Bad request — body failed schema validation. '401': description: Unauthorized — bearer token missing or invalid. '403': description: Forbidden — caller lacks the required scope. '500': description: Internal error. security: - consoleDelegation: [] components: securitySchemes: consoleDelegation: bearerFormat: JWT description: >- Signed Console delegation, valid for at most 30 seconds and bound to the exact HTTP request, resource scope and pinned connection. Accepted only on the dedicated Console listener over private SSH, never on the ordinary gateway. Spec: `sdk/console-authority`. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.