---
title: "Create a Bulkjob"
method: POST
path: "/kg/v3/enhance/bulk"
tags: ["Bulk Enhance"]
---

# Create a Bulkjob

`POST /kg/v3/enhance/bulk`

Enhance multiple records in bulk asynchronously

## Query parameters

- `name` string
- `size` integer
- `threshold` number, double
- `refresh` boolean
- `search` boolean
- `nonCanonicalFacts` boolean
- `jsonmode` ' ' | 'extended'
- `webhookurl` string

## Request body

- union[]
  - union
    - object
      - `type` string — Diffbot entity type
      - `location` string — Location of the entity to enhance. Parameter can be used with types `Person` and `Organization`
      - `ip` string — IP address of the entity to enhance. Parameter can be used with types `Person` and `Organization`
      - `phone` string — Phone of the entity to enhance. Parameter can be used with types `Person` and `Organization`
      - `description` string — Description of the entity to enhance. Parameter can be used with types `Person` and `Organization`
    - object
      - `type` string — Diffbot entity type
      - `location` string — Location of the entity to enhance. Parameter can be used with types `Person` and `Organization`
      - `ip` string — IP address of the entity to enhance. Parameter can be used with types `Person` and `Organization`
      - `phone` string — Phone of the entity to enhance. Parameter can be used with types `Person` and `Organization`
      - `description` string — Description of the entity to enhance. Parameter can be used with types `Person` and `Organization`
      - `email` FieldWrapper — Email of the entity to enhance. Parameter can be used only with type `Person`
        - `empty` boolean
      - `employer` string — Employer of the entity to enhance. Parameter can be used only with type `Person`
      - `title` string — Title of the entity to enhance. Parameter can be used only with type `Person`
      - `school` string — School of the entity to enhance. Parameter can be used only with type `Person`
    - object
      - `id` string — DiffbotId of entity to enhance. Parameter can be used with types `Person` and `Organization`

## Response `202`

Acknowledgement with bulkjobId

- BulkjobAccepted
  - `job_id` string — Bulkjob Id for checking status and downloading results

## Other responses

- `400` — Error parsing request
- `401` — Token not specified or other client errors
- `429` — Insufficient credits
- `500` — Internal Server Error

---

[API](https://skmtc.net/diffbot/apis/web-search.md) · [All operations](https://skmtc.net/diffbot/apis/web-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/diffbot/web-search/versions/8b88d7dabe63/schema)