---
title: "Create Chain"
method: POST
path: "/v1/chains"
tags: ["chains"]
---

# Create Chain

`POST /v1/chains`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/chains`
- Auth: none declared

## Headers

- `authorization` string

## Request body

- CreateChainRequest
  - `goal` string, required
  - `item_description` string, required
  - `staffing_deadline` string, date-time, required
  - `links` ChainLinkIn[], required
    - `title` string, required
    - `instructions` string, required
    - `deliverable` string, required
    - `location` Location
      - `address` string, nullable
      - `lat` number, nullable
      - `lng` number, nullable
    - `required_capabilities` string[], required
    - `budget_max_minor` integer, required
    - `deadline` string, date-time, nullable
    - `duration_after_receipt` string, duration, nullable
    - `proof_requirements` string[]
    - `proof_requirement_opt_outs` string[]
    - `request_live_location` boolean
  - `handoffs` ChainHandoffIn[], required
    - `after_link` integer, required
    - `window_start` string, date-time, required
    - `window_end` string, date-time, required
    - `area` ChainArea
      - `lat` number, required
      - `lng` number, required
      - `radius_km` number, required
  - `currency` string
  - `idempotency_key` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mundane/apis/mundane-api.md) · [All operations](https://skmtc.dev/mundane/apis/mundane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mundane/apis/mundane-api/revisions/f1cba6e69834?raw)