---
title: "Add items to intake"
method: POST
path: "/v1/intakes/{id}/items"
tags: ["Intakes"]
---

# Add items to intake

`POST /v1/intakes/{id}/items`

## Request

- Base URL: `https://api.briefgate.dev`
- URL: `https://api.briefgate.dev/v1/intakes/{id}/items`
- Auth: HTTP bearer

Add new item definitions to an existing intake. Item keys must be unique across the intake. Not restricted to `draft`/`sent` status — adding to a `completed` intake re-opens it (moves it back to `in_progress` and reschedules chases) so the client sees the new items.

## Path parameters

- `id` string, required

## Request body

- AddItems
  - `items` object[], required
    - `key` string, required
    - `type` 'text' | 'longtext' | 'file' | 'file_list' | 'image' | 'color_list' | 'select' | 'multiselect' | 'boolean' | 'url' | 'secret' | 'structured', required
    - `assignee` 'client' | 'owner'
    - `label` string, required
    - `help` string
    - `required` boolean
    - `constraints` object
      - `formats` string[]
      - `min_width` integer
      - `min_height` integer
      - `max_width` integer
      - `max_height` integer
      - `max_bytes` integer
      - `min_chars` integer
      - `max_chars` integer
      - `min_count` integer
      - `max_count` integer
      - `transparent_background` boolean
    - `schema` object
    - `options` object[]
      - `value` string, required
      - `label` string, required
    - `pattern` string
    - `proposed` object
      - `value` union, required
        - string
        - string[]
      - `rationale` string

## Response `201`

Items added

- object
  - `intake_id` string, required
  - `items_added` object[], required
    - `key` string
    - `status` 'pending'

## Other responses

- `400`: Invalid request — malformed body or query parameters
- `401`: Missing or invalid API key
- `403`: Authenticated but not allowed to perform this action
- `404`: Resource not found
- `409`: Duplicate item key
- `422`: Validation error — the body shape is correct but values are invalid

---

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