--- title: "/tasks" method: GET path: "/v1/tasks" tags: ["Tasks"] --- # /tasks `GET /v1/tasks` The `GET /tasks` method, without a task identifier, lists all created tasks for the authenticated organization, with pagination. ## Query parameters - `type` string[] - `status` string[] - `page` integer - `pageSize` integer - `sortBy` 'createdAt' | 'updatedAt' - `sortDirection` 'asc' | 'desc' ## Response `200` Paginated list of tasks. - ListTasksOutput - `metadata` object, required - `page` number, required - `pageSize` number, required - `total` number, required - `totalPages` number, required - `data` TaskOutput[], required - union - object - `createdAt` string, date-time, required — The date and time when the task was created. - `error` string, nullable, required — The error message if the task failed. - `id` string, required — The unique identifier of the task. - `status` 'completed' | 'failed' | 'pending' | 'processing', required — The current status of the task. - `updatedAt` string, date-time, required — The date and time when the task status was last updated. - `input` SearchTaskInput, required - `excludeDomains` string[] — The domains you want to exclude of the search. By default, don't restrict the search. - `fromDate` string, nullable — The date from which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be before `toDate`, if provided, and later than 1970-01-01. - `includeDomains` string[] — The domains you want to search on. By default, don't restrict the search. You can provide up to 100 domains. - `q` string, required — The natural language question for which you want to retrieve context. - `structuredOutputSchema` unknown - `toDate` string, nullable — The date until which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be later than `fromDate`, if provided, or than 1970-01-01. - `depth` 'deep' | 'fast' | 'standard', required — Defines the precision of the search. [BETA] `fast` is a sub-second search mode optimized for simple, focused queries; `standard` leverages agentic search to handle broader queries spanning multiple topics or sources, while remaining fast; `deep` leverages several iterations of agentic search to return comprehensive results, optimizing for coverage. - `includeImages` union — Defines whether the API should include images in its results. - boolean - string - `includeInlineCitations` union — Relevant only when `outputType` is `sourcedAnswer`. Defines whether the answer should include inline citations. - boolean - string - `includeSources` union — Relevant only when `outputType` is `structured`. Defines whether the response should include sources. **Please note that it modifies the schema of the response, see below** - boolean - string - `maxResults` number — The maximum number of results to return. The number of results will always be ≤ to maxResults. - `outputType` 'searchResults' | 'sourcedAnswer' | 'structured', required — The type of output you want to get. Use `structured` for a custom-formatted response defined by `structuredOutputSchema`. - `output` union, required - SourcedAnswerOutput - `answer` string, required — The answer to your question. - `sources` Source[], required — List of sources used to answer the question. - … - SearchResultsOutput - `results` union[], required — List of search results. - … - StructuredWithSourcesOutput - `data` object, required — The object corresponding to the JSON schema you used in the `structuredOutputSchema` param. - `sources` union[], required — List of sources used to answer the question. - … - StructuredOutput - `type` 'search', required - object - `createdAt` string, date-time, required — The date and time when the task was created. - `error` string, nullable, required — The error message if the task failed. - `id` string, required — The unique identifier of the task. - `status` 'completed' | 'failed' | 'pending' | 'processing', required — The current status of the task. - `updatedAt` string, date-time, required — The date and time when the task status was last updated. - `input` FetchTaskInput, required - `extractImages` union — Defines whether the API should extract the images from the webpage in its response. - boolean - string - `includeRawHtml` union — Defines whether the API should include the raw HTML of the webpage in its response. - boolean - string - `renderJs` union — Defines whether the API should render the JavaScript of the webpage. - boolean - string - `url` string, uri, required — The URL of the webpage you want to fetch. - `output` FetchOutput, required - `images` FetchImageOutput[] — List of images extracted from the webpage. - `alt` string, required — The alt text of the image. - `url` string, uri, required — The URL of the image. - `markdown` string, required — The clean markdown version of the webpage. - `rawHtml` string — The raw HTML version of the webpage. - `type` 'fetch', required - object - `createdAt` string, date-time, required — The date and time when the task was created. - `error` string, nullable, required — The error message if the task failed. - `id` string, required — The unique identifier of the task. - `status` 'completed' | 'failed' | 'pending' | 'processing', required — The current status of the task. - `updatedAt` string, date-time, required — The date and time when the task status was last updated. - `input` ResearchTaskInput, required - `excludeDomains` string[] — The domains you want to exclude of the search. By default, don't restrict the search. - `fromDate` string, nullable — The date from which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be before `toDate`, if provided, and later than 1970-01-01. - `includeDomains` string[] — The domains you want to search on. By default, don't restrict the search. You can provide up to 100 domains. - `q` string, required — The natural language question for which you want to retrieve context. - `structuredOutputSchema` unknown - `toDate` string, nullable — The date until which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be later than `fromDate`, if provided, or than 1970-01-01. - `mode` 'answer' | 'auto' | 'investigate' | 'research' — Pin the research agent mode. Omit to let the agent auto-classify per request based on the question. - `outputType` 'sourcedAnswer' | 'structured', required — The type of output you want to get. Use `structured` for a custom-formatted response defined by `structuredOutputSchema`. - `reasoningDepth` 'L' | 'M' | 'S' | 'XL' — Pin the reasoning depth (S < M < L < XL). Defaults to L when omitted. Higher depths trade latency for thoroughness. - `output` union, required - ResearchSourcedAnswerOutput - `answer` string, required — The answer to your question. - `sources` Source[], required — List of sources used to answer the question. - … - StructuredOutput - `type` 'research', required - object — [BETA] Extract task output. The extract task type is in beta; its behavior and response shape may change. - `createdAt` string, date-time, required — The date and time when the task was created. - `error` string, nullable, required — The error message if the task failed. - `id` string, required — The unique identifier of the task. - `status` 'completed' | 'failed' | 'pending' | 'processing', required — The current status of the task. - `updatedAt` string, date-time, required — The date and time when the task status was last updated. - `input` ExtractTaskInput, required — [BETA] Input for an extract task. The extract task type is in beta; its behavior and response shape may change. - `q` string, required — [BETA] The natural-language query describing which rows to extract and what each row should contain. - `schema` unknown - `url` string, uri, required — [BETA] The seed URL the extract task should start from. - `verifyUrls` boolean — [BETA] Defines whether URLs found in extracted rows should be checked for reachability after extraction. Defaults to false. - `output` ExtractOutput, required — [BETA] Output for an extract task. The extracted rows are stored as an NDJSON file and exposed through a time-limited URL. The extract task type is in beta; its behavior and response shape may change. - `creditsUsed` number, required — [BETA] Credits used by this extract task. - `resultUrl` string, uri, required — [BETA] URL to download the extracted rows as a newline-delimited JSON (NDJSON) file. The URL remains valid for 24 hours. - `rowsReturned` integer, required - `type` 'extract', required - `quota` TasksQuota, required - `inFlight` integer, required — Number of tasks currently pending or processing for the organization. - `limit` integer, required — Maximum number of concurrent pending or processing tasks allowed. ## Other responses - `401` — Unauthorized - Invalid or missing API key --- [API](https://skmtc.dev/linkup/apis/linkup-api.md) · [All operations](https://skmtc.dev/linkup/apis/linkup-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/linkup/linkup-api/revisions/1e5050ee899a/schema)