---
title: "Import tracked Pitch handles"
method: POST
path: "/api/pitch/tracking"
---

# Import tracked Pitch handles

`POST /api/pitch/tracking`

## Request

- Base URL: `https://bidclub.ai`
- URL: `https://bidclub.ai/api/pitch/tracking`
- Auth: none declared. Required headers: `Idempotency-Key`

Verified administrators may add up to 1,000 literal handles or profile URLs in at most 64 KiB. This updates tracking only and never starts retrieval.

## Headers

- `Idempotency-Key` string, uuid, required

## Request body

- object
  - `input` string, required

## Response `200`

Audited import result; no retrieval started.

- object
  - `added` string[], required
  - `duplicates` string[], required
  - `invalid` object[], required
    - `value` string, required
    - `reason` string, required
  - `handles` string[], required

## Other responses

- `400`: Malformed body or operation identifier.
- `403`: Origin, identity, or membership rejected.
- `409`: Operation identifier conflict.
- `413`: Import input exceeds 64 KiB.
- `415`: Content type is not application/json.
- `503`: Authentication or tracking storage unavailable.

---

[API](https://skmtc.dev/bidclub/apis/bidclub-open-podcast-transcript-api.md) · [All operations](https://skmtc.dev/bidclub/apis/bidclub-open-podcast-transcript-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bidclub/apis/bidclub-open-podcast-transcript-api/revisions/a097c20ae335?raw)
