# Respona API

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.respona.com/_mcp/server

## Docs

- [Introduction](https://docs.respona.com/guides/getting-started/introduction.md): The Respona Public API for creating, launching, and tracking link-placement orders.
- [Quickstart](https://docs.respona.com/guides/getting-started/quickstart.md): Create a key, build a draft order, launch it, and poll it to LIVE.
- [Authentication](https://docs.respona.com/guides/getting-started/authentication.md): API keys, scopes, IP allowlists, and rotation.
- [Orders & Placements](https://docs.respona.com/guides/core-concepts/orders-placements.md): The resource shape, quality tiers, pricing modifiers, and the state machine.
- [Concerns](https://docs.respona.com/guides/core-concepts/concerns.md): Raise and hold a message thread with the Respona team about a placement.
- [Credits & Billing](https://docs.respona.com/guides/core-concepts/credits-billing.md): How pricing, credits, the monthly pool, and refunds work.
- [Polling for Status](https://docs.respona.com/guides/core-concepts/polling-for-status.md): How to observe placement progress until it reaches a terminal state.
- [Webhooks](https://docs.respona.com/guides/core-concepts/webhooks.md): Get pushed a signed event the moment an order or placement changes status, instead of polling.
- [Idempotency](https://docs.respona.com/guides/api-conventions/idempotency.md): Safely retrying launches without double-charging.
- [Rate Limits](https://docs.respona.com/guides/api-conventions/rate-limits.md): Request limits, response headers, and handling 429s.
- [Errors](https://docs.respona.com/guides/api-conventions/errors.md): The error envelope, HTTP status codes, and machine-readable error codes.

## API Docs

- Orders API > Orders [Create Order](https://docs.respona.com/api-reference/orders-api/orders/create-order.md)
- Orders API > Orders [Add Placements](https://docs.respona.com/api-reference/orders-api/orders/add-placements.md)
- Orders API > Orders [Launch Order](https://docs.respona.com/api-reference/orders-api/orders/launch-order.md)
- Orders API > Orders [Get Order](https://docs.respona.com/api-reference/orders-api/orders/get-order.md)
- Orders API > Orders [Delete Order](https://docs.respona.com/api-reference/orders-api/orders/delete-order.md)
- Orders API > Orders [Get Placement](https://docs.respona.com/api-reference/orders-api/orders/get-placement.md)
- Orders API > Orders [Remove Placement](https://docs.respona.com/api-reference/orders-api/orders/remove-placement.md)
- Orders API > Orders [Approve Placement](https://docs.respona.com/api-reference/orders-api/orders/approve-placement.md)
- Orders API > Orders [Reject Placement](https://docs.respona.com/api-reference/orders-api/orders/reject-placement.md)
- Orders API > Orders [Get Concern](https://docs.respona.com/api-reference/orders-api/orders/get-concern.md)
- Orders API > Orders [Raise Concern](https://docs.respona.com/api-reference/orders-api/orders/raise-concern.md)
- Orders API > Orders [Add Concern Message](https://docs.respona.com/api-reference/orders-api/orders/add-concern-message.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.respona.com/openapi.json)
- [OpenAPI YAML](https://docs.respona.com/openapi.yaml)