--- title: "List Tasks" method: GET path: "/agents/{agent_id}/tasks" tags: ["tasks"] --- # List Tasks `GET /agents/{agent_id}/tasks` ## Path parameters - `agent_id` string, uuid, required ## Query parameters - `limit` integer - `offset` integer - `sort_by` 'created_at' | 'updated_at' - `direction` 'asc' | 'desc' ## Response `200` Successful Response - ListResponseTask - `items` Task[], required - `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[] - … - string - `tools` union - 'all' - union[] - … - `tool_choice` union - 'auto' | 'none' - NamedToolChoice - … - `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 - … - EvaluateStep - … - ToolCallStep - … - PromptStepOutput - … - GetStep - … - SetStep - … - LogStep - … - YieldStep - … - ReturnStep - … - SleepStep - … - ErrorWorkflowStep - … - IfElseWorkflowStepOutput — recursive - SwitchStepOutput - … - ForeachStepOutput - … - ParallelStepOutput - … - ThenOutput — The steps to run if the condition is true - … - `else` union - WaitForInputStep - … - EvaluateStep - … - ToolCallStep - … - PromptStepOutput - … - GetStep - … - SetStep - … - LogStep - … - YieldStep - … - ReturnStep - … - SleepStep - … - ErrorWorkflowStep - … - IfElseWorkflowStepOutput — recursive - SwitchStepOutput - … - ForeachStepOutput - … - ParallelStepOutput - … - ElseOutput — The steps to run if the condition is false - … - SwitchStepOutput - `kind_` 'switch' - `label` string, nullable - `switch` CaseThenOutput[], required - `case` union, required - … - `then` union, required - … - ForeachStepOutput - `kind_` 'foreach' - `label` string, nullable - `foreach` ForeachDoOutput, required - `in` string, required - `do` union, required - … - ParallelStepOutput - `kind_` 'parallel' - `label` string, nullable - `parallel` union[], required - union - … - MainOutput - `kind_` 'map_reduce' - `label` string, nullable - `over` string, required - `map` union, required - EvaluateStep - … - ToolCallStep - … - PromptStepOutput - … - GetStep - … - SetStep - … - LogStep - … - YieldStep - … - `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 - … - 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 - … - 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 - … - `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 - … - 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 `items/items/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 `items/items/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 `items/items/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 `items/items/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/agents/:agent_id/tasks/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)