Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.outkit.dev/llms.txt

Use this file to discover all available pages before exploring further.

The Outkit REST API lets you enhance AI text responses from any language, framework, or backend. Send raw text in, get structured UI components back.

Base URL

https://api.outkit.dev

Authentication

All endpoints require an API key passed in the x-outkit-api-key header:
curl https://api.outkit.dev/components \
  -H "x-outkit-api-key: your-api-key"
The fastest way to create one is the CLI:
npm install -g @outkit-dev/cli@latest
outkit login
outkit keys create -n "dev"
The plaintext key is shown exactly once. You can also create keys from app.outkit.dev.
Never expose your API key in client-side code. Call the Outkit API from your backend and forward results to your frontend.

Endpoints

MethodPathDescriptionAuth
POST/render/enhanceTransform text into UI componentsRequired
GET/componentsList available component typesRequired

Response Format

All endpoints return JSON. Successful responses return 200. Errors return structured JSON with an error and detail field:
{
  "error": "InputTooLargeError",
  "detail": "Content exceeds maximum allowed size"
}

Error Codes

StatusErrorMeaning
400BadRequestInvalid or missing request parameters
401UnauthorizedMissing or invalid API key
403ForbiddenAPI key is revoked or team is inactive
413InputTooLargeErrorContent exceeds 512 KB
422ValidationErrorRequest body failed schema validation
429RateLimitExceededToo many requests — slow down
500InternalErrorUnexpected server error
502ProviderErrorLLM processing failed
503ProviderUnavailableErrorLLM provider temporarily unavailable
504ProviderTimeoutErrorLLM processing timed out

Rate Limits

Rate limits depend on your plan:
PlanRequests per minuteMax components per response
Free105
Pro1008
Additional plans with higher limits are available. See outkit.dev for details.
When rate limited, you’ll receive a 429 response. Implement exponential backoff in your client.

Rate Limit Headers

Every response includes rate limit headers:
HeaderDescription
X-RateLimit-LimitMaximum requests per minute for your plan
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix epoch timestamp when the window resets
Retry-AfterSeconds to wait before retrying (only on 429 responses)

Content Limits

  • Maximum request body size: 512 KB
  • Requests exceeding this limit receive a 413 response

CORS

The API accepts requests from any origin (Access-Control-Allow-Origin: *), but you should still route requests through your own backend to protect your API key.