> ## Documentation Index > Fetch the complete documentation index at: https://docs.alcamine.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a Session ## OpenAPI ````yaml GET /sessions/{id} openapi: 3.1.0 info: title: Alcamine API foo version: 1.0.0 description: Alcamine admin API servers: - url: https://api.alcamine.com description: Current environment security: - bearerAuth: [] paths: /sessions/{id}: get: tags: - Sessions parameters: - schema: type: string format: cuid2 required: true name: id in: path responses: '200': description: Session content: application/json: schema: $ref: '#/components/schemas/Session' '404': description: Not found components: schemas: Session: type: object properties: id: type: string maxLength: 24 format: cuid2 createdAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' updatedAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' name: type: string maxLength: 255 type: type: string enum: - INBOUND_CALL - WEB_VOICE status: type: string enum: - PENDING - IN_PROGRESS - COMPLETED completedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' lastHeartbeatAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' startedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' endedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' recordAudio: type: boolean isDemo: type: boolean agentId: type: string maxLength: 24 agentVersionId: type: string maxLength: 24 workspaceId: type: string maxLength: 24 format: cuid2 personId: type: string maxLength: 24 conversationId: type: string maxLength: 24 completedMeta: type: - object - 'null' properties: traceId: type: string agent: type: object properties: id: type: string maxLength: 24 format: cuid2 createdAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' updatedAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' createdBy: type: - string - 'null' format: cuid2 updatedBy: type: - string - 'null' format: cuid2 workspaceId: type: string maxLength: 24 format: cuid2 publishedVersionId: type: - string - 'null' maxLength: 24 name: type: string maxLength: 255 description: type: - string - 'null' maxLength: 500 slug: type: string maxLength: 255 status: type: string enum: - DRAFT - ARCHIVED - PUBLISHED - COMPLETED sourceTemplateId: type: - string - 'null' maxLength: 24 archivedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' archivedBy: type: - string - 'null' maxLength: 24 completedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' completedBy: type: - string - 'null' maxLength: 24 publishedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' publishedBy: type: - string - 'null' maxLength: 24 version: type: object properties: id: type: string maxLength: 24 format: cuid2 createdAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' updatedAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' createdBy: type: - string - 'null' format: cuid2 updatedBy: type: - string - 'null' format: cuid2 agentId: type: string maxLength: 24 version: type: integer minimum: -2147483648 maximum: 2147483647 workspaceId: type: string maxLength: 24 sourceAgentVersionId: type: - string - 'null' maxLength: 24 themeId: type: string maxLength: 24 incentiveType: type: string enum: - CASH - NONE incentiveAmount: type: - integer - 'null' minimum: 100 maximum: 1000000 incentiveCurrencyCode: type: - string - 'null' enum: - USD maxParticipants: type: - integer - 'null' minimum: -2147483648 maximum: 2147483647 length: type: string enum: - FIVE_MINUTES - TEN_MINUTES - FIFTEEN_MINUTES - THIRTY_MINUTES - FORTY_FIVE_MINUTES languages: type: array items: type: string enum: - en - es - fr inputMode: type: array items: type: string enum: - SMS - PHONE - WEB_CHAT - WEB_VOICE knowledgeBaseId: type: - string - 'null' maxLength: 24 followUp: type: boolean limitToKnowledgeBase: type: - boolean - 'null' timezone: type: - string - 'null' maxLength: 255 authentication: type: string enum: - NONE - CODE systemPrompt: type: - string - 'null' agentFlowId: type: - string - 'null' maxLength: 24 config: anyOf: - type: object properties: llm: oneOf: - type: object properties: provider: type: string enum: - OPENAI model: type: string enum: - GPT_4O - GPT_4_1 - GPT_4_1_MINI - GPT_4O_NANO temperature: type: number minimum: 0 maximum: 2 required: - provider - model - type: object properties: provider: type: string enum: - GEMINI model: type: string enum: - GEMINI_2_0_FLASH_001 - GEMINI_2_5_FLASH_PREVIEW_4_17 temperature: type: number minimum: 0 maximum: 2 required: - provider - model tts: oneOf: - type: object properties: provider: type: string enum: - CARTESIA model: type: string enum: - SONIC_2 voiceId: type: string minLength: 1 required: - provider - model - voiceId - type: object properties: provider: type: string enum: - ELEVENLABS model: type: string enum: - MULTILINGUAL_V2 voiceId: type: string minLength: 1 required: - provider - model - voiceId stt: oneOf: - type: object properties: provider: type: string enum: - DEEPGRAM model: type: string enum: - NOVA_3 required: - provider - model - type: object properties: provider: type: string enum: - CARTESIA model: type: string enum: - INK_WHISPER required: - provider - model - type: 'null' - type: 'null' required: - id - createdAt - updatedAt - createdBy - updatedBy - agentId - version - workspaceId - sourceAgentVersionId - themeId - incentiveType - incentiveAmount - incentiveCurrencyCode - maxParticipants - length - languages - inputMode - knowledgeBaseId - followUp - limitToKnowledgeBase - timezone - authentication - systemPrompt - agentFlowId - config required: - id - createdAt - updatedAt - createdBy - updatedBy - workspaceId - publishedVersionId - name - description - slug - status - sourceTemplateId - archivedBy - completedBy - publishedBy - version conversation: type: object properties: id: type: string maxLength: 24 format: cuid2 createdAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' updatedAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' workspaceId: type: string maxLength: 24 format: cuid2 personId: type: string maxLength: 24 name: type: string maxLength: 255 isDemo: type: boolean lastViewedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' lastViewedBy: type: - string - 'null' maxLength: 24 format: cuid2 lastSessionEndedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' archivedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' archivedBy: type: - string - 'null' maxLength: 24 format: cuid2 required: - id - createdAt - updatedAt - workspaceId - personId - name - isDemo - lastViewedAt - lastViewedBy - lastSessionEndedAt - archivedAt - archivedBy person: type: object properties: id: type: string maxLength: 24 format: cuid2 createdAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' updatedAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' workspaceId: type: string maxLength: 24 format: cuid2 properties: type: object additionalProperties: {} firstSeenAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' lastSeenAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' identifiedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' deletedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' email: type: - string - 'null' maxLength: 255 format: email phone: type: - string - 'null' pattern: ^\+[1-9]\d{1,15}$ rootPersonId: type: string maxLength: 24 format: cuid2 mergedBy: type: - string - 'null' maxLength: 24 format: cuid2 mergedAt: anyOf: - type: string format: date - type: string - type: 'null' format: date-time example: '2023-12-25T00:00:00.000Z' mergeMeta: type: object additionalProperties: {} required: - id - createdAt - updatedAt - workspaceId - properties - firstSeenAt - lastSeenAt - identifiedAt - deletedAt - email - phone - rootPersonId - mergedBy - mergedAt - mergeMeta ledger: type: - object - 'null' properties: id: type: string maxLength: 24 format: cuid2 createdAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' updatedAt: anyOf: - type: string format: date - type: string format: date-time example: '2023-12-25T00:00:00.000Z' createdBy: type: - string - 'null' format: cuid2 updatedBy: type: - string - 'null' format: cuid2 workspaceId: type: string maxLength: 24 amount: type: integer minimum: -2147483648 maximum: 2147483647 reason: type: string enum: - INITIAL_BALANCE - PURCHASE_REFILL - SUBSCRIPTION_REFILL - REDEMPTION_CODE - VOICE_USAGE - SMS_USAGE reasonDetails: type: - string - 'null' maxLength: 255 redemptionCodeId: type: - string - 'null' maxLength: 24 agentId: type: - string - 'null' maxLength: 24 sessionId: type: - string - 'null' maxLength: 24 idempotencyKey: type: - string - 'null' maxLength: 255 required: - id - createdAt - updatedAt - createdBy - updatedBy - workspaceId - amount - reason - reasonDetails - redemptionCodeId - agentId - sessionId - idempotencyKey required: - id - createdAt - updatedAt - name - type - status - completedAt - lastHeartbeatAt - startedAt - endedAt - recordAudio - isDemo - agentId - agentVersionId - workspaceId - personId - conversationId - agent - conversation - person - ledger securitySchemes: bearerAuth: type: http scheme: bearer ````