> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eden.art/llms.txt
> Use this file to discover all available pages before exploring further.

# Interact with Session

> Send a message to an existing session or create a new session with the first message.



## OpenAPI

````yaml openapi.json post /v2/sessions
openapi: 3.0.0
info:
  title: '@fastify/swagger'
  description: API for Eden.art platform
  version: 8.14.0
servers:
  - url: https://api.eden.art
    description: Production server
  - url: https://api-staging.eden.art
    description: Staging server
  - url: http://localhost:8080
    description: Development server
security: []
tags:
  - name: Agent Creation
    description: Operations related to agent creation
  - name: Agents
    description: Operations related to agents
  - name: Agents - Deployments
    description: Operations related to agents - deployments
  - name: Agents - Memory
    description: Operations related to agents - memory
  - name: Agents - Triggers
    description: Operations related to agents - triggers
  - name: API Keys
    description: Operations related to api keys
  - name: Collections
    description: Operations related to collections
  - name: Concepts V2
    description: Operations related to concepts v2
  - name: Creations
    description: Operations related to creations
  - name: Creators
    description: Operations related to creators
  - name: Manna
    description: Operations related to manna
  - name: Models
    description: Operations related to models
  - name: Sessions
    description: Operations related to sessions
  - name: Sessions - Permissions
    description: Operations related to sessions - permissions
  - name: Tasks
    description: Operations related to tasks
  - name: Tools
    description: Operations related to tools
paths:
  /v2/sessions:
    post:
      tags:
        - Sessions
      summary: Interact with Session
      description: >-
        Send a message to an existing session or create a new session with the
        first message.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                session_id:
                  type: string
                content:
                  type: string
                attachments:
                  type: array
                  items:
                    type: string
                stream:
                  type: boolean
                thinking:
                  type: boolean
                agent_ids:
                  type: array
                  items:
                    type: string
                scenario:
                  maxLength: 1000
                  type: string
                budget:
                  type: object
                  properties:
                    manna_budget:
                      minimum: 100
                      maximum: 50000
                      type: number
                    token_budget:
                      minimum: 1000
                      maximum: 1000000
                      type: number
                    turn_budget:
                      minimum: 1
                      maximum: 1000
                      type: number
                title:
                  maxLength: 1000
                  type: string
                autonomy_settings:
                  type: object
                  properties:
                    auto_reply:
                      type: boolean
                    reply_interval:
                      minimum: 0
                      maximum: 3600
                      type: number
                    actor_selection_method:
                      anyOf:
                        - type: string
                          enum:
                            - random
                        - type: string
                          enum:
                            - random_exclude_last
                  required:
                    - auto_reply
                    - reply_interval
                    - actor_selection_method
                extras:
                  type: object
                  properties:
                    exclude_memory:
                      type: boolean
      responses:
        '200':
          description: Default Response
          content:
            '*/*':
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                required:
                  - session_id
        '400':
          description: Default Response
          content:
            '*/*':
              schema:
                type: object
                properties:
                  message:
                    type: string
        '401':
          description: Default Response
          content:
            '*/*':
              schema:
                type: object
                properties:
                  message:
                    type: string
        '404':
          description: Default Response
          content:
            '*/*':
              schema:
                type: object
                properties:
                  message:
                    type: string
        '500':
          description: Default Response
          content:
            '*/*':
              schema:
                type: object
                properties:
                  error: {}
                  message:
                    type: string
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-Api-Key
      in: header

````