---
title: "Send a prompt through the ClawPipe pipeline."
method: POST
path: "/v1/prompt"
tags: ["Pipeline"]
---

# Send a prompt through the ClawPipe pipeline.

`POST /v1/prompt`

## Request

- Base URL: `https://api.clawpipe.ai`
- URL: `https://api.clawpipe.ai/v1/prompt`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- PromptRequest
  - `prompt` string, required
  - `provider` string, required
  - `model` string, required
  - `system` string
  - `maxTokens` integer
  - `temperature` number

## Response `200`

OK

- PromptResponse
  - `text` string, required
  - `tokensIn` integer, required
  - `tokensOut` integer, required
  - `latencyMs` integer, required
  - `request_id` string, uuid
  - `meta` object
    - `attribution` string
    - `savings` object

## Other responses

- `400`: Invalid request body or parameters.
- `401`: Missing or invalid bearer token.
- `402`: Monthly budget exceeded.
- `413`: Prompt or system message too large.
- `429`: Daily quota exceeded.
- `502`: Upstream provider error.
- `503`: Provider not configured.

---

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