> ## Documentation Index > Fetch the complete documentation index at: https://factory-docs-cli-sandbox-mcp-whole-process.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get a session > Returns detailed session information including settings and stats. This feature is enabled for selected organizations only. ## OpenAPI ````yaml https://api.factory.ai/api/v0/openapi.json get /api/v0/sessions/{sessionId} openapi: 3.0.1 info: title: Factory Public API description: >- Public API for Factory platform. Requires authentication via the `Authorization: Bearer` header. version: 0.1.0 servers: - url: https://api.factory.ai/ description: Production security: - BearerAuth: [] paths: /api/v0/sessions/{sessionId}: get: tags: - Sessions summary: Get a session description: >- Returns detailed session information including settings and stats. This feature is enabled for selected organizations only. operationId: getSession parameters: - name: sessionId in: path required: true schema: type: string description: Session ID - name: computerId in: query required: false schema: type: string description: Computer ID to query directly responses: '200': description: Response for status 200 content: application/json: schema: $ref: '#/components/schemas/GetSession200ResponseBody' '401': description: Response for status 401 content: application/json: schema: $ref: '#/components/schemas/GetSession401ResponseBody' '403': description: Response for status 403 content: application/json: schema: $ref: '#/components/schemas/GetSession403ResponseBody' '404': description: Response for status 404 content: application/json: schema: $ref: '#/components/schemas/GetSession404ResponseBody' '500': description: Response for status 500 content: application/json: schema: $ref: '#/components/schemas/GetSession500ResponseBody' '503': description: Response for status 503 content: application/json: schema: $ref: '#/components/schemas/GetSession503ResponseBody' components: schemas: GetSession200ResponseBody: type: object properties: sessionId: type: string description: Session ID title: type: string description: Session title status: type: string enum: - idle - pending - running description: Current session execution status messageCount: type: integer description: Number of messages in session createdAt: type: integer description: Creation timestamp (Unix ms) updatedAt: type: integer description: Last update timestamp (Unix ms) completedAt: type: integer description: Completion timestamp (Unix ms) computerId: type: string description: Connected computer ID sessionSettings: type: object properties: model: type: string reasoningEffort: type: string enum: - none - dynamic - 'off' - minimal - low - medium - high - xhigh - max interactionMode: type: string enum: - auto - spec - agi - mission autonomyLevel: type: string enum: - 'off' - low - medium - high autonomyMode: type: string enum: - normal - spec - auto-low - auto-medium - auto-high description: 'Deprecated: use interactionMode + autonomyLevel instead.' specModeModel: type: string specModeReasoningEffort: type: string enum: - none - dynamic - 'off' - minimal - low - medium - high - xhigh - max runInWorktree: type: boolean providerLock: type: string enum: - anthropic - openai - generic-chat-completion-api - factory - google - xai - voyage - bedrock-converse providerLockTimestamp: type: string apiProviderLock: type: string enum: - bedrock - anthropic - vertex_anthropic - bedrock_anthropic - bedrock_converse - bedrock_openai - openai - azure_openai - google - xai - fireworks - baseten - snowflake assistantActiveTimeMs: type: number tokenUsage: type: object properties: inputTokens: type: number outputTokens: type: number cacheCreationTokens: type: number cacheReadTokens: type: number thinkingTokens: type: number factoryCredits: type: number required: - inputTokens - outputTokens - cacheCreationTokens - cacheReadTokens - thinkingTokens additionalProperties: false inclusiveTokenUsage: type: object properties: inputTokens: type: number outputTokens: type: number cacheCreationTokens: type: number cacheReadTokens: type: number thinkingTokens: type: number factoryCredits: type: number required: - inputTokens - outputTokens - cacheCreationTokens - cacheReadTokens - thinkingTokens additionalProperties: false childInclusiveTokenUsageBySessionId: type: object additionalProperties: type: object properties: inputTokens: type: number outputTokens: type: number cacheCreationTokens: type: number cacheReadTokens: type: number thinkingTokens: type: number factoryCredits: type: number required: - inputTokens - outputTokens - cacheCreationTokens - cacheReadTokens - thinkingTokens additionalProperties: false archivedAt: type: string tags: type: array items: type: object properties: name: type: string minLength: 1 metadata: type: object additionalProperties: type: string required: - name additionalProperties: false enabledToolIds: type: array items: type: string disabledToolIds: type: array items: type: string compactionModel: anyOf: - type: string enum: - current-model - type: string enum: - claude-3-5-sonnet-20241022 - claude-3-7-sonnet-20250219 - claude-sonnet-4-20250514 - claude-opus-4-1-20250805 - claude-3-5-haiku-20241022 - claude-sonnet-4-5-20250929 - claude-opus-4-5-20251101 - claude-haiku-4-5-20251001 - claude-sonnet-4-6 - claude-opus-4-6 - claude-opus-4-6-fast - claude-opus-4-7 - claude-opus-4-7-fast - claude-opus-4-8 - claude-opus-4-8-fast - claude-fable-5 - aspen-05-15 - almond-05-27 - anise-06-16 - gpt-5-2025-08-07 - gpt-5-mini-2025-08-07 - gpt-5-nano-2025-08-07 - gpt-5-codex - gpt-5.1 - gpt-5.1-codex - gpt-5.1-codex-max - gpt-5.2 - gpt-5.2-codex - gpt-5.3-codex - gpt-5.3-codex-fast - gpt-5.4 - gpt-5.4-fast - gpt-5.4-mini - gpt-5.5 - gpt-5.5-fast - gpt-5.5-pro - olm-03-05 - orbit-04-09 - oxide-06-01 - oxbow-06-01 - owl-06-21 - gemini-2.5-flash - gemini-2.5-pro - gemini-3-pro-preview - gemini-3-flash-preview - gemini-3.1-pro-preview - gemini-3.5-flash - gantry-05-07 - titan-02-12 - glm-4.6 - glm-4.7 - kimi-k2.5 - kimi-k2.6 - kimi-k2.7-code - deepseek-v4-pro - minimax-m2.5 - minimax-m2.7 - minimax-m3 - glm-5 - glm-5.1 - glm-5.2 - nemotron-3-ultra - olive-05-22 - oriel-06-01 - ocelot-06-01 - okappa-alpha - omaffa-alpha - type: string pattern: ^custom:.+$ compactionThresholdCheckEnabled: type: boolean additionalProperties: false required: - sessionId - status - messageCount - createdAt - updatedAt additionalProperties: false GetSession401ResponseBody: type: object properties: detail: type: string description: Human-readable error message status: type: number description: HTTP status code title: type: string description: HTTP status title metadata: type: object additionalProperties: {} description: Additional error metadata required: - detail - status - title additionalProperties: false GetSession403ResponseBody: type: object properties: detail: type: string description: Human-readable error message status: type: number description: HTTP status code title: type: string description: HTTP status title metadata: type: object additionalProperties: {} description: Additional error metadata required: - detail - status - title additionalProperties: false GetSession404ResponseBody: type: object properties: detail: type: string description: Human-readable error message status: type: number description: HTTP status code title: type: string description: HTTP status title metadata: type: object additionalProperties: {} description: Additional error metadata required: - detail - status - title additionalProperties: false GetSession500ResponseBody: type: object properties: detail: type: string description: Human-readable error message status: type: number description: HTTP status code title: type: string description: HTTP status title metadata: type: object additionalProperties: {} description: Additional error metadata required: - detail - status - title additionalProperties: false GetSession503ResponseBody: type: object properties: detail: type: string description: Human-readable error message status: type: number description: HTTP status code title: type: string description: HTTP status title metadata: type: object additionalProperties: {} description: Additional error metadata required: - detail - status - title additionalProperties: false securitySchemes: BearerAuth: type: http scheme: bearer description: Factory API key or JWT token for authentication ````