---
title: "Get Task Details"
method: GET
path: "/tasks/{task_id}"
tags: ["tasks"]
---

# Get Task Details

`GET /tasks/{task_id}`

## Path parameters

- `task_id` string, uuid, required

## Response `200`

Successful Response

- Task
  - `name` string, required
  - `canonical_name` string, nullable
  - `description` string
  - `main` union[], required
    - union
      - EvaluateStep
        - `kind_` 'evaluate'
        - `label` string, nullable
        - `evaluate` object, required
      - ToolCallStep
        - `kind_` 'tool_call'
        - `label` string, nullable
        - `tool` string, required
        - `arguments` union
          - object
          - '_'
      - PromptStepOutput
        - `kind_` 'prompt'
        - `label` string, nullable
        - `prompt` union, required
          - PromptItemOutput[]
            - `role` 'user' | 'assistant' | 'system' | 'tool', required
            - `tool_call_id` string, nullable
            - `content` union, required
              - …
            - `name` string, nullable
            - `tool_calls` union[], nullable
              - …
          - string
        - `tools` union
          - 'all'
          - union[]
            - union
              - …
        - `tool_choice` union
          - 'auto' | 'none'
          - NamedToolChoice
            - `function` FunctionCallOption
              - …
        - `settings` object, nullable
        - `unwrap` boolean
        - `auto_run_tools` boolean
        - `disable_cache` boolean
      - GetStep
        - `kind_` 'get'
        - `label` string, nullable
        - `get` string, required
      - SetStep
        - `kind_` 'set'
        - `label` string, nullable
        - `set` object, required
      - LogStep
        - `kind_` 'log'
        - `label` string, nullable
        - `log` string, required
      - YieldStep
        - `kind_` 'yield'
        - `label` string, nullable
        - `workflow` string, required
        - `arguments` union
          - object
          - '_'
      - ReturnStep
        - `kind_` 'return'
        - `label` string, nullable
        - `return` object, required
      - SleepStep
        - `kind_` 'sleep'
        - `label` string, nullable
        - `sleep` SleepFor, required
          - `seconds` integer
          - `minutes` integer
          - `hours` integer
          - `days` integer
      - ErrorWorkflowStep
        - `kind_` 'error'
        - `label` string, nullable
        - `error` string, required
      - WaitForInputStep
        - `kind_` 'wait_for_input'
        - `label` string, nullable
        - `wait_for_input` WaitForInputInfo, required
          - `info` object, required
      - IfElseWorkflowStepOutput
        - `kind_` 'if_else'
        - `label` string, nullable
        - `if` string, required
        - `then` union, required
          - WaitForInputStep
            - `kind_` 'wait_for_input'
            - `label` string, nullable
            - `wait_for_input` WaitForInputInfo, required
              - …
          - EvaluateStep
            - `kind_` 'evaluate'
            - `label` string, nullable
            - `evaluate` object, required
          - ToolCallStep
            - `kind_` 'tool_call'
            - `label` string, nullable
            - `tool` string, required
            - `arguments` union
              - …
          - PromptStepOutput
            - `kind_` 'prompt'
            - `label` string, nullable
            - `prompt` union, required
              - …
            - `tools` union
              - …
            - `tool_choice` union
              - …
            - `settings` object, nullable
            - `unwrap` boolean
            - `auto_run_tools` boolean
            - `disable_cache` boolean
          - GetStep
            - `kind_` 'get'
            - `label` string, nullable
            - `get` string, required
          - SetStep
            - `kind_` 'set'
            - `label` string, nullable
            - `set` object, required
          - LogStep
            - `kind_` 'log'
            - `label` string, nullable
            - `log` string, required
          - YieldStep
            - `kind_` 'yield'
            - `label` string, nullable
            - `workflow` string, required
            - `arguments` union
              - …
          - ReturnStep
            - `kind_` 'return'
            - `label` string, nullable
            - `return` object, required
          - SleepStep
            - `kind_` 'sleep'
            - `label` string, nullable
            - `sleep` SleepFor, required
              - …
          - ErrorWorkflowStep
            - `kind_` 'error'
            - `label` string, nullable
            - `error` string, required
          - IfElseWorkflowStepOutput — recursive
          - SwitchStepOutput
            - `kind_` 'switch'
            - `label` string, nullable
            - `switch` CaseThenOutput[], required
              - …
          - ForeachStepOutput
            - `kind_` 'foreach'
            - `label` string, nullable
            - `foreach` ForeachDoOutput, required
              - …
          - ParallelStepOutput
            - `kind_` 'parallel'
            - `label` string, nullable
            - `parallel` union[], required
              - …
          - ThenOutput — The steps to run if the condition is true
            - `kind_` 'map_reduce'
            - `label` string, nullable
            - `over` string, required
            - `map` union, required
              - …
            - `reduce` string, nullable
            - `initial` unknown
            - `parallelism` integer, nullable
        - `else` union
          - WaitForInputStep
            - `kind_` 'wait_for_input'
            - `label` string, nullable
            - `wait_for_input` WaitForInputInfo, required
              - …
          - EvaluateStep
            - `kind_` 'evaluate'
            - `label` string, nullable
            - `evaluate` object, required
          - ToolCallStep
            - `kind_` 'tool_call'
            - `label` string, nullable
            - `tool` string, required
            - `arguments` union
              - …
          - PromptStepOutput
            - `kind_` 'prompt'
            - `label` string, nullable
            - `prompt` union, required
              - …
            - `tools` union
              - …
            - `tool_choice` union
              - …
            - `settings` object, nullable
            - `unwrap` boolean
            - `auto_run_tools` boolean
            - `disable_cache` boolean
          - GetStep
            - `kind_` 'get'
            - `label` string, nullable
            - `get` string, required
          - SetStep
            - `kind_` 'set'
            - `label` string, nullable
            - `set` object, required
          - LogStep
            - `kind_` 'log'
            - `label` string, nullable
            - `log` string, required
          - YieldStep
            - `kind_` 'yield'
            - `label` string, nullable
            - `workflow` string, required
            - `arguments` union
              - …
          - ReturnStep
            - `kind_` 'return'
            - `label` string, nullable
            - `return` object, required
          - SleepStep
            - `kind_` 'sleep'
            - `label` string, nullable
            - `sleep` SleepFor, required
              - …
          - ErrorWorkflowStep
            - `kind_` 'error'
            - `label` string, nullable
            - `error` string, required
          - IfElseWorkflowStepOutput — recursive
          - SwitchStepOutput
            - `kind_` 'switch'
            - `label` string, nullable
            - `switch` CaseThenOutput[], required
              - …
          - ForeachStepOutput
            - `kind_` 'foreach'
            - `label` string, nullable
            - `foreach` ForeachDoOutput, required
              - …
          - ParallelStepOutput
            - `kind_` 'parallel'
            - `label` string, nullable
            - `parallel` union[], required
              - …
          - ElseOutput — The steps to run if the condition is false
            - `kind_` 'map_reduce'
            - `label` string, nullable
            - `over` string, required
            - `map` union, required
              - …
            - `reduce` string, nullable
            - `initial` unknown
            - `parallelism` integer, nullable
      - SwitchStepOutput
        - `kind_` 'switch'
        - `label` string, nullable
        - `switch` CaseThenOutput[], required
          - `case` union, required
            - '_'
            - string
          - `then` union, required
            - EvaluateStep
              - …
            - ToolCallStep
              - …
            - PromptStepOutput
              - …
            - GetStep
              - …
            - SetStep
              - …
            - LogStep
              - …
            - YieldStep
              - …
            - ReturnStep
              - …
            - SleepStep
              - …
            - ErrorWorkflowStep
              - …
            - WaitForInputStep
              - …
      - ForeachStepOutput
        - `kind_` 'foreach'
        - `label` string, nullable
        - `foreach` ForeachDoOutput, required
          - `in` string, required
          - `do` union, required
            - WaitForInputStep
              - …
            - EvaluateStep
              - …
            - ToolCallStep
              - …
            - PromptStepOutput
              - …
            - GetStep
              - …
            - SetStep
              - …
            - LogStep
              - …
            - YieldStep
              - …
      - ParallelStepOutput
        - `kind_` 'parallel'
        - `label` string, nullable
        - `parallel` union[], required
          - union
            - EvaluateStep
              - …
            - ToolCallStep
              - …
            - PromptStepOutput
              - …
            - GetStep
              - …
            - SetStep
              - …
            - LogStep
              - …
            - YieldStep
              - …
      - MainOutput
        - `kind_` 'map_reduce'
        - `label` string, nullable
        - `over` string, required
        - `map` union, required
          - EvaluateStep
            - `kind_` 'evaluate'
            - `label` string, nullable
            - `evaluate` object, required
          - ToolCallStep
            - `kind_` 'tool_call'
            - `label` string, nullable
            - `tool` string, required
            - `arguments` union
              - …
          - PromptStepOutput
            - `kind_` 'prompt'
            - `label` string, nullable
            - `prompt` union, required
              - …
            - `tools` union
              - …
            - `tool_choice` union
              - …
            - `settings` object, nullable
            - `unwrap` boolean
            - `auto_run_tools` boolean
            - `disable_cache` boolean
          - GetStep
            - `kind_` 'get'
            - `label` string, nullable
            - `get` string, required
          - SetStep
            - `kind_` 'set'
            - `label` string, nullable
            - `set` object, required
          - LogStep
            - `kind_` 'log'
            - `label` string, nullable
            - `log` string, required
          - YieldStep
            - `kind_` 'yield'
            - `label` string, nullable
            - `workflow` string, required
            - `arguments` union
              - …
        - `reduce` string, nullable
        - `initial` unknown
        - `parallelism` integer, nullable
  - `input_schema` object, nullable
  - `tools` TaskToolOutput[]
    - `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
          - `brave_api_key` string, required
        - `arguments` BraveSearchArguments — Arguments for Brave Search
          - `query` string, required
      - EmailIntegrationDef — Email integration definition
        - `provider` 'email'
        - `method` string, nullable
        - `setup` EmailSetup — Setup parameters for Email integration
          - `host` string, required
          - `port` integer, required
          - `user` string, required
          - `password` string, required
        - `arguments` EmailArguments — Arguments for Email sending
          - `to` string, required
          - `from` string, required
          - `subject` string, required
          - `body` string, required
      - SpiderIntegrationDef — Spider integration definition
        - `provider` 'spider'
        - `method` 'crawl' | 'links' | 'screenshot' | 'search', nullable
        - `setup` SpiderSetup — Setup parameters for Spider integration
          - `spider_api_key` string, required
        - `arguments` SpiderFetchArguments — Arguments for Spider integration
          - `url` string, uri, required
          - `content_type` 'application/json' | 'text/csv' | 'application/xml' | 'application/jsonl'
          - `params` object, nullable
      - WikipediaIntegrationDef — Wikipedia integration definition
        - `provider` 'wikipedia'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` WikipediaSearchArguments — Arguments for Wikipedia Search
          - `query` string, required
          - `load_max_docs` integer
      - WeatherIntegrationDef — Weather integration definition
        - `provider` 'weather'
        - `method` string, nullable
        - `setup` WeatherSetup — Integration definition for Weather
          - `openweathermap_api_key` string, required
        - `arguments` WeatherGetArguments — Arguments for Weather
          - `location` string, required
      - MailgunIntegrationDef — Mailgun integration definition
        - `provider` 'mailgun'
        - `method` 'send_email', nullable
        - `setup` MailgunSetup — Setup parameters for Mailgun integration
          - `api_key` string, required
        - `arguments` MailgunSendEmailArguments — Arguments for mailgun.send_email method
          - `to` string, required
          - `from` string, required
          - `subject` string, required
          - `body` string, required
          - `cc` string, nullable
          - `bcc` string, nullable
      - BrowserbaseContextIntegrationDef — browserbase context provider
        - `provider` 'browserbase'
        - `method` 'create_context'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseContextArguments
          - `projectId` string, required
      - BrowserbaseExtensionIntegrationDef — browserbase extension provider
        - `provider` 'browserbase'
        - `method` 'install_extension_from_github', nullable
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseExtensionArguments
          - `repositoryName` string, required
          - `ref` string, nullable
      - BrowserbaseListSessionsIntegrationDef — browserbase list sessions integration definition
        - `provider` 'browserbase'
        - `method` 'list_sessions'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseListSessionsArguments
          - `status` 'RUNNING' | 'ERROR' | 'TIMED_OUT' | 'COMPLETED', nullable
      - BrowserbaseCreateSessionIntegrationDef — browserbase create session integration definition
        - `provider` 'browserbase'
        - `method` 'create_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseCreateSessionArguments
          - `projectId` string, nullable
          - `extensionId` string, nullable
          - `browserSettings` object
          - `timeout` integer
          - `keepAlive` boolean
          - `proxies` union
            - boolean
            - object[]
              - …
      - BrowserbaseGetSessionIntegrationDef — browserbase get session integration definition
        - `provider` 'browserbase'
        - `method` 'get_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseGetSessionArguments
          - `id` string, required
      - BrowserbaseCompleteSessionIntegrationDef — browserbase complete session integration definition
        - `provider` 'browserbase'
        - `method` 'complete_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseCompleteSessionArguments
          - `id` string, required
          - `status` 'REQUEST_RELEASE'
      - BrowserbaseGetSessionLiveUrlsIntegrationDef — browserbase get session live urls integration definition
        - `provider` 'browserbase'
        - `method` 'get_live_urls'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseGetSessionLiveUrlsArguments
          - `id` string, required
      - RemoteBrowserIntegrationDef — The integration definition for the remote browser
        - `provider` 'remote_browser'
        - `method` 'perform_action'
        - `setup` RemoteBrowserSetup, required — The setup parameters for the remote browser
          - `connect_url` string, nullable
          - `width` integer, nullable
          - `height` integer, nullable
        - `arguments` RemoteBrowserArguments — The arguments for the remote browser
          - `connect_url` string, nullable
          - `action` 'key' | 'type' | 'mouse_move' | 'left_click' | 'left_click_drag' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot' | 'cursor_position' | 'navigate' | 'refresh', required
          - `text` string, nullable
          - `coordinate` unknown[], nullable
            - unknown
      - LlamaParseIntegrationDef — LlamaParse integration definition
        - `provider` 'llama_parse'
        - `method` string, nullable
        - `setup` LlamaParseSetup — Setup parameters for LlamaParse integration
          - `llamaparse_api_key` string, required
          - `params` object, nullable
        - `arguments` LlamaParseFetchArguments — Arguments for LlamaParse integration
          - `filename` string, nullable
          - `file` union, required
            - string
            - string[]
          - `params` object, nullable
          - `base64` boolean
      - FfmpegIntegrationDef — Ffmpeg integration definition
        - `provider` 'ffmpeg'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` FfmpegSearchArguments — Arguments for Ffmpeg CMD
          - `cmd` string, required
          - `file` union
            - string
            - string[]
      - CloudinaryUploadIntegrationDef — Cloudinary upload integration definition
        - `provider` 'cloudinary'
        - `method` 'media_upload'
        - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
          - `cloudinary_api_key` string, required
          - `cloudinary_api_secret` string, required
          - `cloudinary_cloud_name` string, required
          - `params` object, nullable
        - `arguments` CloudinaryUploadArguments — Arguments for Cloudinary media upload
          - `file` string, required
          - `return_base64` boolean
          - `public_id` string, nullable
          - `upload_params` object, nullable
      - CloudinaryEditIntegrationDef — Cloudinary edit integration definition
        - `provider` 'cloudinary'
        - `method` 'media_edit'
        - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
          - `cloudinary_api_key` string, required
          - `cloudinary_api_secret` string, required
          - `cloudinary_cloud_name` string, required
          - `params` object, nullable
        - `arguments` CloudinaryEditArguments — Arguments for Cloudinary media edit
          - `public_id` string, required
          - `transformation` object[], required
          - `return_base64` boolean
      - ArxivIntegrationDef — Arxiv integration definition
        - `provider` 'arxiv'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` ArxivSearchArguments — Arguments for Arxiv Search
          - `query` string, required
          - `id_list` string[], nullable
          - `max_results` integer
          - `download_pdf` boolean
          - `sort_by` 'relevance' | 'lastUpdatedDate' | 'submittedDate'
          - `sort_order` 'ascending' | 'descending'
      - UnstructuredIntegrationDef — Unstructured integration definition
        - `provider` 'unstructured'
        - `method` string, nullable
        - `setup` UnstructuredSetup — Setup parameters for Unstructured integration
          - `unstructured_api_key` string, required
          - `server_url` string, nullable
          - `server` string, nullable
          - `url_params` object, nullable
          - `retry_config` object, nullable
          - `timeout_ms` integer, nullable
        - `arguments` UnstructuredPartitionArguments — Arguments for Unstructured partition integration
          - `filename` string, nullable
          - `file` string, required
          - `partition_params` object, nullable
      - AlgoliaIntegrationDef — Algolia integration definition
        - `provider` 'algolia'
        - `method` string, nullable
        - `setup` AlgoliaSetup — Integration definition for Algolia
          - `algolia_application_id` string, required
          - `algolia_api_key` string, required
        - `arguments` AlgoliaSearchArguments — Arguments for Algolia Search
          - `index_name` string, required
          - `query` string, required
          - `attributes_to_retrieve` string[], nullable
          - `hits_per_page` integer
    - `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
    - `inherited` boolean
  - `inherit_tools` boolean
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `metadata` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2025-07-11** `21c8182519ef` — 15 warning
  - removed the optional property `main/items/anyOf[subschema #12: IfElseWorkflowStep]/else/anyOf[subschema #13: SwitchStep]/switch/items/then/anyOf[subschema #3: PromptStep]/prompt/anyOf[subschema #1]/items/continue` from the response with the `200` status
  - removed the optional property `main/items/anyOf[subschema #12: IfElseWorkflowStep]/else/anyOf[subschema #14: ForeachStep]/foreach/do/anyOf[subschema #4: PromptStep]/prompt/anyOf[subschema #1]/items/continue` from the response with the `200` status
  - removed the optional property `main/items/anyOf[subschema #12: IfElseWorkflowStep]/else/anyOf[subschema #15: ParallelStep]/parallel/items/anyOf[subschema #3: PromptStep]/prompt/anyOf[subschema #1]/items/continue` from the response with the `200` status
  - removed the optional property `main/items/anyOf[subschema #12: IfElseWorkflowStep]/else/anyOf[subschema #16: Else]/map/anyOf[subschema #3: PromptStep]/prompt/anyOf[subschema #1]/items/continue` from the response with the `200` status
  - …11 more
- …earlier changes not shown

[Full history](https://skmtc.dev/julep-ai/apis/julep-agents-api/changes/tasks/:task_id/get.md)

---

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