---
title: "Create"
method: POST
path: "/tasks/{task_id}/contracts"
tags: ["tasks"]
---

# Create

`POST /tasks/{task_id}/contracts`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/tasks/{task_id}/contracts`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `task_id` string, uuid, required

## Request body

- ContractTerms: What the tenant declares for a version of a task's contract.
  - `input_schema` object, required
  - `rules` union[]
    - union
      - JsonRule
        - `name` string, required
        - `check` 'json', required
      - LabelRule
        - `name` string, required
        - `check` 'label', required
        - `labels` string[], required
        - `field` string, nullable
  - `slices` Slice[]
    - `name` string, required
    - `path` string, required
    - `values` union[], required
      - union
        - string
        - integer
        - boolean
    - `min_n` integer, required
  - `claim` 'same_quality' | 'economy' | 'improvement'
  - `tolerance` number
  - `latency_p95_ms` number, nullable
  - `data_uses` AllowedUse[], required
  - `outcomes` OutcomeSpec[]
    - `name` string, required
    - `kind` 'binary' | 'numeric', required
    - `window_days` integer, required

## Response `201`

Successful Response

- Contract
  - `id` string, uuid, required
  - `task_id` string, uuid, required
  - `version` integer, required
  - `record` object, required
  - `sha256` string, nullable, required
  - `created_by` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `frozen_by` string, nullable, required
  - `frozen_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

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