---
title: "Get Session History"
method: GET
path: "/sessions/{session_id}/history"
tags: ["sessions"]
---

# Get Session History

`GET /sessions/{session_id}/history`

## Path parameters

- `session_id` string, uuid, required

## Response `200`

Successful Response

- History
  - `entries` Entry[], required
    - `role` 'user' | 'assistant' | 'system' | 'tool', required
    - `name` string, nullable
    - `content` union, required
      - union[]
        - union
          - ContentOutput
            - `text` string, required
            - `type` 'text'
          - AgentsApiAutogenEntriesContentModel3
            - `image_url` ImageUrl, required — The image URL
              - …
            - `type` 'image_url'
          - AgentsApiAutogenEntriesContentModel — Anthropic image content part
            - `tool_use_id` string, required
            - `type` 'tool_result'
            - `content` union, required
              - …
      - Tool
        - `name` string, required
        - `type` 'function' | 'integration' | 'system' | 'api_call' | 'computer_20241022' | 'text_editor_20241022' | 'bash_20241022', required
        - `description` string, nullable
        - `function` FunctionDef — Function definition
          - `name` unknown
          - `description` unknown
          - `parameters` object, nullable
        - `integration` union
          - DummyIntegrationDef
            - `provider` 'dummy'
            - `method` string, nullable
            - `setup` unknown
            - `arguments` unknown
          - BraveIntegrationDef — Brave integration definition
            - `provider` 'brave'
            - `method` string, nullable
            - `setup` BraveSearchSetup — Integration definition for Brave Search
              - …
            - `arguments` BraveSearchArguments — Arguments for Brave Search
              - …
          - EmailIntegrationDef — Email integration definition
            - `provider` 'email'
            - `method` string, nullable
            - `setup` EmailSetup — Setup parameters for Email integration
              - …
            - `arguments` EmailArguments — Arguments for Email sending
              - …
          - SpiderIntegrationDef — Spider integration definition
            - `provider` 'spider'
            - `method` 'crawl' | 'links' | 'screenshot' | 'search', nullable
            - `setup` SpiderSetup — Setup parameters for Spider integration
              - …
            - `arguments` SpiderFetchArguments — Arguments for Spider integration
              - …
          - WikipediaIntegrationDef — Wikipedia integration definition
            - `provider` 'wikipedia'
            - `method` string, nullable
            - `setup` unknown
            - `arguments` WikipediaSearchArguments — Arguments for Wikipedia Search
              - …
          - WeatherIntegrationDef — Weather integration definition
            - `provider` 'weather'
            - `method` string, nullable
            - `setup` WeatherSetup — Integration definition for Weather
              - …
            - `arguments` WeatherGetArguments — Arguments for Weather
              - …
          - MailgunIntegrationDef — Mailgun integration definition
            - `provider` 'mailgun'
            - `method` 'send_email', nullable
            - `setup` MailgunSetup — Setup parameters for Mailgun integration
              - …
            - `arguments` MailgunSendEmailArguments — Arguments for mailgun.send_email method
              - …
          - BrowserbaseContextIntegrationDef — browserbase context provider
            - `provider` 'browserbase'
            - `method` 'create_context'
            - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
              - …
            - `arguments` BrowserbaseContextArguments
              - …
          - BrowserbaseExtensionIntegrationDef — browserbase extension provider
            - `provider` 'browserbase'
            - `method` 'install_extension_from_github', nullable
            - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
              - …
            - `arguments` BrowserbaseExtensionArguments
              - …
          - BrowserbaseListSessionsIntegrationDef — browserbase list sessions integration definition
            - `provider` 'browserbase'
            - `method` 'list_sessions'
            - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
              - …
            - `arguments` BrowserbaseListSessionsArguments
              - …
          - BrowserbaseCreateSessionIntegrationDef — browserbase create session integration definition
            - `provider` 'browserbase'
            - `method` 'create_session'
            - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
              - …
            - `arguments` BrowserbaseCreateSessionArguments
              - …
          - BrowserbaseGetSessionIntegrationDef — browserbase get session integration definition
            - `provider` 'browserbase'
            - `method` 'get_session'
            - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
              - …
            - `arguments` BrowserbaseGetSessionArguments
              - …
          - BrowserbaseCompleteSessionIntegrationDef — browserbase complete session integration definition
            - `provider` 'browserbase'
            - `method` 'complete_session'
            - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
              - …
            - `arguments` BrowserbaseCompleteSessionArguments
              - …
          - BrowserbaseGetSessionLiveUrlsIntegrationDef — browserbase get session live urls integration definition
            - `provider` 'browserbase'
            - `method` 'get_live_urls'
            - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
              - …
            - `arguments` BrowserbaseGetSessionLiveUrlsArguments
              - …
          - RemoteBrowserIntegrationDef — The integration definition for the remote browser
            - `provider` 'remote_browser'
            - `method` 'perform_action'
            - `setup` RemoteBrowserSetup, required — The setup parameters for the remote browser
              - …
            - `arguments` RemoteBrowserArguments — The arguments for the remote browser
              - …
          - LlamaParseIntegrationDef — LlamaParse integration definition
            - `provider` 'llama_parse'
            - `method` string, nullable
            - `setup` LlamaParseSetup — Setup parameters for LlamaParse integration
              - …
            - `arguments` LlamaParseFetchArguments — Arguments for LlamaParse integration
              - …
          - FfmpegIntegrationDef — Ffmpeg integration definition
            - `provider` 'ffmpeg'
            - `method` string, nullable
            - `setup` unknown
            - `arguments` FfmpegSearchArguments — Arguments for Ffmpeg CMD
              - …
          - CloudinaryUploadIntegrationDef — Cloudinary upload integration definition
            - `provider` 'cloudinary'
            - `method` 'media_upload'
            - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
              - …
            - `arguments` CloudinaryUploadArguments — Arguments for Cloudinary media upload
              - …
          - CloudinaryEditIntegrationDef — Cloudinary edit integration definition
            - `provider` 'cloudinary'
            - `method` 'media_edit'
            - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
              - …
            - `arguments` CloudinaryEditArguments — Arguments for Cloudinary media edit
              - …
          - ArxivIntegrationDef — Arxiv integration definition
            - `provider` 'arxiv'
            - `method` string, nullable
            - `setup` unknown
            - `arguments` ArxivSearchArguments — Arguments for Arxiv Search
              - …
          - UnstructuredIntegrationDef — Unstructured integration definition
            - `provider` 'unstructured'
            - `method` string, nullable
            - `setup` UnstructuredSetup — Setup parameters for Unstructured integration
              - …
            - `arguments` UnstructuredPartitionArguments — Arguments for Unstructured partition integration
              - …
          - AlgoliaIntegrationDef — Algolia integration definition
            - `provider` 'algolia'
            - `method` string, nullable
            - `setup` AlgoliaSetup — Integration definition for Algolia
              - …
            - `arguments` AlgoliaSearchArguments — Arguments for Algolia Search
              - …
        - `system` SystemDef — System definition
          - `resource` 'agent' | 'user' | 'task' | 'execution' | 'doc' | 'session' | 'job', required
          - `operation` 'create' | 'update' | 'patch' | 'create_or_update' | 'embed' | 'change_status' | 'search' | 'chat' | 'history' | 'delete' | 'get' | 'list', required
          - `resource_id` string, uuid, nullable
          - `subresource` 'tool' | 'doc' | 'execution' | 'transition', nullable
          - `arguments` object, nullable
        - `api_call` ApiCallDefOutput — API call definition
          - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'CONNECT' | 'TRACE', required
          - `url` string, uri, required
          - `schema` object, nullable
          - `headers` object, nullable
          - `secrets` object, nullable
          - `content` string, nullable
          - `data` object, nullable
          - `files` object, nullable
          - `json` object, nullable
          - `cookies` object, nullable
          - `params` union
            - string
            - object
          - `params_schema` ParameterSchemaOutput — JSON Schema for API call parameters
            - `type` string
            - `properties` object, required
            - `required` string[]
            - `additionalProperties` boolean, nullable
          - `follow_redirects` boolean, nullable
          - `timeout` integer, nullable
          - `include_response_content` boolean
        - `computer_20241022` Computer20241022Def — Anthropic new tools
          - `type` 'computer_20241022'
          - `name` string
          - `display_width_px` integer
          - `display_height_px` integer
          - `display_number` integer
        - `text_editor_20241022` TextEditor20241022Def
          - `type` 'text_editor_20241022'
          - `name` string
        - `bash_20241022` Bash20241022Def
          - `type` 'bash_20241022'
          - `name` string
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `id` string, uuid, required
      - ChosenFunctionCall
        - `type` 'function'
        - `function` FunctionCallOption, required
          - `name` string, required
          - `arguments` string, nullable
        - `integration` unknown
        - `system` unknown
        - `api_call` unknown
        - `computer_20241022` ChosenComputer20241022
          - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
          - `text` string, nullable
          - `coordinate` integer[], nullable
        - `text_editor_20241022` ChosenTextEditor20241022
          - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
          - `path` string, required
          - `file_text` string, nullable
          - `insert_line` integer, nullable
          - `new_str` string, nullable
          - `old_str` string, nullable
          - `view_range` integer[], nullable
        - `bash_20241022` ChosenBash20241022
          - `command` string, nullable
          - `restart` boolean
        - `id` string, nullable
      - ChosenComputer20241022
        - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
        - `text` string, nullable
        - `coordinate` integer[], nullable
      - ChosenTextEditor20241022
        - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
        - `path` string, required
        - `file_text` string, nullable
        - `insert_line` integer, nullable
        - `new_str` string, nullable
        - `old_str` string, nullable
        - `view_range` integer[], nullable
      - ChosenBash20241022
        - `command` string, nullable
        - `restart` boolean
      - string
      - ToolResponse
        - `id` string, required
        - `output` object, required
      - union[]
        - union
          - union[]
            - union
              - …
          - Tool
            - `name` string, required
            - `type` 'function' | 'integration' | 'system' | 'api_call' | 'computer_20241022' | 'text_editor_20241022' | 'bash_20241022', required
            - `description` string, nullable
            - `function` FunctionDef — Function definition
              - …
            - `integration` union
              - …
            - `system` SystemDef — System definition
              - …
            - `api_call` ApiCallDefOutput — API call definition
              - …
            - `computer_20241022` Computer20241022Def — Anthropic new tools
              - …
            - `text_editor_20241022` TextEditor20241022Def
              - …
            - `bash_20241022` Bash20241022Def
              - …
            - `created_at` string, date-time, required
            - `updated_at` string, date-time, required
            - `id` string, uuid, required
          - ChosenFunctionCall
            - `type` 'function'
            - `function` FunctionCallOption, required
              - …
            - `integration` unknown
            - `system` unknown
            - `api_call` unknown
            - `computer_20241022` ChosenComputer20241022
              - …
            - `text_editor_20241022` ChosenTextEditor20241022
              - …
            - `bash_20241022` ChosenBash20241022
              - …
            - `id` string, nullable
          - ChosenComputer20241022
            - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
            - `text` string, nullable
            - `coordinate` integer[], nullable
          - ChosenTextEditor20241022
            - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
            - `path` string, required
            - `file_text` string, nullable
            - `insert_line` integer, nullable
            - `new_str` string, nullable
            - `old_str` string, nullable
            - `view_range` integer[], nullable
          - ChosenBash20241022
            - `command` string, nullable
            - `restart` boolean
          - string
          - ToolResponse
            - `id` string, required
            - `output` object, required
    - `source` 'api_request' | 'api_response' | 'tool_request' | 'tool_response' | 'internal' | 'summarizer' | 'meta', required
    - `tokenizer` string, required
    - `token_count` integer, required
    - `model` string
    - `tool_calls` union[], nullable
      - union
        - ChosenFunctionCall
          - `type` 'function'
          - `function` FunctionCallOption, required
            - `name` string, required
            - `arguments` string, nullable
          - `integration` unknown
          - `system` unknown
          - `api_call` unknown
          - `computer_20241022` ChosenComputer20241022
            - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
            - `text` string, nullable
            - `coordinate` integer[], nullable
          - `text_editor_20241022` ChosenTextEditor20241022
            - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
            - `path` string, required
            - `file_text` string, nullable
            - `insert_line` integer, nullable
            - `new_str` string, nullable
            - `old_str` string, nullable
            - `view_range` integer[], nullable
          - `bash_20241022` ChosenBash20241022
            - `command` string, nullable
            - `restart` boolean
          - `id` string, nullable
        - ChosenComputer20241022
          - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
          - `text` string, nullable
          - `coordinate` integer[], nullable
        - ChosenTextEditor20241022
          - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
          - `path` string, required
          - `file_text` string, nullable
          - `insert_line` integer, nullable
          - `new_str` string, nullable
          - `old_str` string, nullable
          - `view_range` integer[], nullable
        - ChosenBash20241022
          - `command` string, nullable
          - `restart` boolean
    - `tool_call_id` string, nullable
    - `timestamp` string, date-time, required
    - `created_at` string, date-time, required
    - `id` string, uuid, required
  - `relations` Relation[], required
    - `head` string, uuid, required
    - `relation` string, required
    - `tail` string, uuid, required
  - `session_id` string, uuid, required
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/julep-ai/apis/julep-agents-api.md) · [All operations](https://skmtc.net/julep-ai/apis/julep-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/julep-ai/julep-agents-api/revisions/21c8182519ef/schema)
