---
title: "Create a local harness bounty"
method: POST
path: "/bounties"
---

# Create a local harness bounty

`POST /bounties`

## Request

- Base URL: `https://superskill.sh/api`
- URL: `https://superskill.sh/api/bounties`
- Auth: HTTP bearer

Auth required. Creates open bounty work-state; it does not move money.

## Request body

- BountyCreate
  - `title` string, required
  - `spec` string, required
  - `budget_usd` number, required
  - `currency` string

## Response `201`

Bounty created

- Bounty
  - `id` string, required
  - `title` string, required
  - `spec` string, required
  - `budget_usd` number, required
  - `currency` string, required
  - `status` 'open' | 'claimed' | 'delivered' | 'paid', required
  - `customer_user_id` string, required
  - `claimant_user_id` string, nullable
  - `delivered_harness` string, nullable
  - `delivered_version` string, nullable
  - `delivery_receipt_hash` string, nullable
  - `accepted_receipt_hash` string, nullable
  - `payment_purchase_id` string, nullable
  - `escrow_provider_ref` string, nullable
  - `paid_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Authorization required

---

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