---
title: "Create an expiring quote; does not spend or reserve funds"
method: POST
path: "/quotes"
---

# Create an expiring quote; does not spend or reserve funds

`POST /quotes`

## Request

- Base URL: `https://contentsweep.ai/api/v1`
- URL: `https://contentsweep.ai/api/v1/quotes`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'search' | 'investigate' | 'evidence' | 'prepare' | 'submit' | 'status' | 'monitor', required
  - `input` ActionInput, required
    - `rights_holder_id` string, required
    - `work_id` string, required
    - `delegation_id` string, required
    - `url` string, uri: investigate
    - `main_handle` string: search; existing identity/text matching only
    - `case_id` string
    - `evidence_id` string
    - `packet_id` string
    - `destination` string
    - `good_faith` boolean
    - `accurate_and_authorized` boolean
    - `infringement_explanation` string
    - `target_action` 'search' | 'status'
    - `cadence_hours` integer
    - `expires_at` string, date-time
    - `per_run_limit_cents` integer
    - `total_limit_cents` integer
    - `scenario` 'removed': Sandbox only: synthetic absence; repeated observations still determine removal

## Response `201`

Success

- object

## Other responses

- `402`: Payment required or insufficient credit; MPP challenge may be in WWW-Authenticate
- `409`: Idempotency conflict, stale quote or unreconciled submission
- `429`: Rate or capacity limit
- `503`: Capability not activated
- `default`: Structured denial or error

---

[API](https://skmtc.dev/contentsweep/apis/content-sweep-agent-api.md) · [All operations](https://skmtc.dev/contentsweep/apis/content-sweep-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/contentsweep/apis/content-sweep-agent-api/revisions/bf04acd6172e?raw)