> ## Documentation Index > Fetch the complete documentation index at: https://honcho.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get Or Create Session > Get a Session by ID or create a new Session with the given ID. If Session ID is provided as a parameter, it verifies the Session is in the Workspace. Otherwise, it uses the session_id from the JWT for verification. ## OpenAPI ````yaml post /v3/workspaces/{workspace_id}/sessions openapi: 3.1.0 info: title: Honcho API summary: The Identity Layer for the Agentic World description: >- Honcho is a platform for giving agents user-centric memory and social cognition. contact: name: Plastic Labs url: https://honcho.dev/ email: hello@plasticlabs.ai version: 3.1.0 servers: - url: https://api.honcho.dev description: Production SaaS Platform - url: http://localhost:8000 description: Local Development Server security: [] paths: /v3/workspaces/{workspace_id}/sessions: post: tags: - sessions summary: Get Or Create Session description: >- Get a Session by ID or create a new Session with the given ID. If Session ID is provided as a parameter, it verifies the Session is in the Workspace. Otherwise, it uses the session_id from the JWT for verification. operationId: get_or_create_session_v3_workspaces__workspace_id__sessions_post parameters: - name: workspace_id in: path required: true schema: type: string title: Workspace Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SessionCreate' description: Session creation parameters responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Session' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: SessionCreate: properties: id: type: string maxLength: 512 minLength: 1 pattern: ^[a-zA-Z0-9_-]+$ title: Id metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata peers: anyOf: - additionalProperties: $ref: '#/components/schemas/SessionPeerConfig' type: object - type: 'null' title: Peers configuration: anyOf: - $ref: '#/components/schemas/SessionConfiguration' - type: 'null' scopes: anyOf: - items: type: string type: array maxItems: 100 - type: 'null' title: Scopes description: >- Optional list of (unprefixed) scope names to add this session to. Each scope is created if it does not exist yet. If the session already has messages, its existing documents are backfilled into the scope asynchronously. type: object required: - id title: SessionCreate Session: properties: id: type: string title: Id is_active: type: boolean title: Is Active workspace_id: type: string title: Workspace Id metadata: additionalProperties: true type: object title: Metadata configuration: additionalProperties: true type: object title: Configuration created_at: type: string format: date-time title: Created At type: object required: - id - is_active - workspace_id - created_at title: Session HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SessionPeerConfig: properties: observe_me: anyOf: - type: boolean - type: 'null' title: Observe Me description: >- Whether Honcho will use reasoning to form a representation of this peer observe_others: anyOf: - type: boolean - type: 'null' title: Observe Others description: >- Whether this peer should form a session-level theory-of-mind representation of other peers in the session type: object title: SessionPeerConfig SessionConfiguration: properties: reasoning: anyOf: - $ref: '#/components/schemas/ReasoningConfiguration' - type: 'null' description: Configuration for reasoning functionality. peer_card: anyOf: - $ref: '#/components/schemas/PeerCardConfiguration' - type: 'null' description: >- Configuration for peer card functionality. If reasoning is disabled, peer cards will also be disabled and these settings will be ignored. summary: anyOf: - $ref: '#/components/schemas/SummaryConfiguration' - type: 'null' description: Configuration for summary functionality. dream: anyOf: - $ref: '#/components/schemas/DreamConfiguration' - type: 'null' description: >- Configuration for dream functionality. If reasoning is disabled, dreams will also be disabled and these settings will be ignored. additionalProperties: true type: object title: SessionConfiguration description: >- The set of options that can be in a session DB-level configuration dictionary. All fields are optional. Session-level configuration overrides workspace-level configuration, which overrides global configuration. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ReasoningConfiguration: properties: enabled: anyOf: - type: boolean - type: 'null' title: Enabled description: Whether to enable reasoning functionality. custom_instructions: anyOf: - type: string - type: 'null' title: Custom Instructions description: >- Optional custom instructions for the reasoning system on this workspace/session/message. Rejected if they exceed the deriver custom-instruction token cap. type: object title: ReasoningConfiguration PeerCardConfiguration: properties: use: anyOf: - type: boolean - type: 'null' title: Use description: >- Whether to use peer card related to this peer during reasoning process. create: anyOf: - type: boolean - type: 'null' title: Create description: Whether to generate peer card based on content. type: object title: PeerCardConfiguration SummaryConfiguration: properties: enabled: anyOf: - type: boolean - type: 'null' title: Enabled description: Whether to enable summary functionality. messages_per_short_summary: anyOf: - type: integer minimum: 10 - type: 'null' title: Messages Per Short Summary description: >- Number of messages per short summary. Must be positive, greater than or equal to 10, and less than messages_per_long_summary. messages_per_long_summary: anyOf: - type: integer minimum: 20 - type: 'null' title: Messages Per Long Summary description: >- Number of messages per long summary. Must be positive, greater than or equal to 20, and greater than messages_per_short_summary. type: object title: SummaryConfiguration DreamConfiguration: properties: enabled: anyOf: - type: boolean - type: 'null' title: Enabled description: >- Whether to enable dream functionality. If reasoning is disabled, dreams will also be disabled and this setting will be ignored. type: object title: DreamConfiguration securitySchemes: HTTPBearer: type: http scheme: bearer ````