---
title: "Create a new job"
method: POST
path: "/job/create"
tags: ["Job"]
---

# Create a new job

`POST /job/create`

Creates and enqueues a new Nutch job (e.g., inject, generate, fetch, parse, updatedb, index).

## Request body

- JobConfig — Configuration for creating a new crawl job.
  - `crawlId` string — The crawl identifier.
  - `type` 'INJECT' | 'GENERATE' | 'FETCH' | 'PARSE' | 'UPDATEDB' | 'INDEX' | 'READDB' | 'CLASS' | 'INVERTLINKS' | 'DEDUP', required — The type of Nutch crawl job.
  - `confId` string — The configuration ID to use for this job. Defaults to "default" if not specified.
  - `jobClassName` string — Fully qualified class name when type is CLASS.
  - `args` object — Additional arguments for the job.

## Response `200`

Job created. Returns the job information.

- JobInfo — Information about a crawl job.
  - `id` string — The unique job identifier.
  - `type` 'INJECT' | 'GENERATE' | 'FETCH' | 'PARSE' | 'UPDATEDB' | 'INDEX' | 'READDB' | 'CLASS' | 'INVERTLINKS' | 'DEDUP', required — The type of Nutch crawl job.
  - `confId` string — The configuration ID used for this job.
  - `args` object — Arguments passed to the job.
  - `result` object — Result data returned after job completion.
  - `state` 'IDLE' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'KILLED' | 'STOPPING' | 'KILLING' | 'ANY', required — The current state of a job.
  - `msg` string — A human-readable status or error message.
  - `crawlId` string — The crawl identifier associated with this job.

## Other responses

- `400` — Bad request. The request body is missing, malformed, or contains invalid parameters.
- `401` — Unauthorized. Basic authentication credentials are missing or invalid.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/apache/apis/apache-nutch-rest-api.md) · [All operations](https://skmtc.dev/apache/apis/apache-nutch-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apache/apache-nutch-rest-api/revisions/e67af5b75ede/schema)