---
title: "Create Bulk Request"
method: POST
path: "/workflows/request/crawl/bulk"
tags: ["workflows"]
---

# Create Bulk Request

`POST /workflows/request/crawl/bulk`

Make bulk requests to temporal worker based on the number of URLs

## Request body

- BulkCrawlRequest
  - `jobs` CrawlRequest[], required
    - `bucket_name` string, required
    - `crawl_id` string, required
    - `url` string, required
    - `engines` object[], required
    - `depth` integer
    - `absolute_only` boolean
    - `keep_external` boolean
    - `visit_external` boolean
    - `max_workers` integer
    - `batch_size` integer
    - `max_urls` integer

## Response `200`

Successful Response

- BulkCrawlResponse
  - `results` WorkflowResult[], required
    - `url` string, required
    - `workflow_id` string, required
  - `errors` SubmissionError[], nullable
    - `url` string, nullable
    - `workflow_id` string, nullable
    - `error` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/evrimai/apis/cartography-server.md) · [All operations](https://skmtc.dev/evrimai/apis/cartography-server/llms.txt) · [OpenAPI document](https://skmtc.dev/evrimai/apis/cartography-server/revisions/4eb68ae85080?raw)