KrosAI

Calls

Simulate inbound call

Initiate outbound call

Terminate call

Get Call Status

Get Transcript

List calls

Get call detail

Soft-delete a call record

List call lifecycle events

Get call recording metadata

Control call recording

Endpoints

List endpoints

Create endpoint

Get endpoint

Update endpoint

Delete endpoint

Partial update endpoint

Test endpoint connectivity

Phone Numbers

List phone numbers

Claim or register a phone number

Browse available phone number inventory

Search available phone number inventory with filters

Get phone number

Partial update phone number

Release or delete phone number

Attach or detach endpoint

Detach endpoint from phone number

Phone number diagnostic check

API Keys

List API keys

Create API key

Update API key

Revoke API key

Rotate API key

API key usage

Per-key usage summary

Create SDK session token

Webhooks

List webhooks

Create webhook

Update webhook

Delete webhook

Send a test event to a webhook

Retry a failed webhook delivery

Webhook delivery history

Provider Integrations

List provider integrations

Create or upsert a provider integration

Get a provider integration

Update a provider integration

Delete a provider integration

Test provider integration credentials

Health

Health Check

New Section

INTEGRATION

REFERENCE

COMMUNITY

Discord

GETTING STARTED

Introduction

Quickstart

Authentication

NUMBERS

Buy Numbers

Countries

Vapi

Retell

Elevenlabs

Vogent

Livekit

VOICE

Outbound Calls

Call logs

Recordings

WEBHOOKS

Events

Rate limits

Error Codes

Documentation

API Reference

Default

KrosAI Documentation

Production

Local development

<p class="slate-p slate-indent-0" style="0px">KrosAI applies rate limits to ensure fair usage and platform stability.</p><h2 class="slate-h2 " >Limits by Plan</h2><div class="published-table"><div class="table-container" style="padding-left: 0px;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:139px;">Plan</div><div style="width:145px;"> Requests/Second</div><div style="width:199px;">Requests/Day</div><div style="width:196px;">Concurrent Calls</div></div><table class="slate-table" style="width:679px;min-width:679px;table-layout:fixed;"><colgroup ><col style="width:139px"><col style="width:145px"><col style="width:199px"><col style="width:196px"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><td class="slate-td"><p class="slate-p " >Free</p></td><td class="slate-td"><p class="slate-p " >10</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">1,000</p></td><td class="slate-td"><p class="slate-p " >1</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p " >Pro</p></td><td class="slate-td"><p class="slate-p " >50</p></td><td class="slate-td"><p class="slate-p " >50,000</p></td><td class="slate-td"><p class="slate-p " >10</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p " >Business</p></td><td class="slate-td"><p class="slate-p " >200</p></td><td class="slate-td"><p class="slate-p " >500,000</p></td><td class="slate-td"><p class="slate-p " >50</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p " >Enterprise</p></td><td class="slate-td"><p class="slate-p " >Custom</p></td><td class="slate-td"><p class="slate-p " >Custom</p></td><td class="slate-td"><p class="slate-p " >Unlimited</p></td></tr></tbody></table></div></div><h2 class="slate-h2 " >Rate Limit Headers</h2><p class="slate-p slate-indent-0" style="0px">Every API response includes rate limit information:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">X-RateLimit-Limit: 50</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">X-RateLimit-Remaining: 45</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">X-RateLimit-Reset: 1704891600</strong></div></li></ul><div class="published-table"><div class="table-container" style="padding-left: 0px;"><div class="published-table-header" style="width:100%;min-width:100%;"><div >Title</div><div >Description</div></div><table class="slate-table" style="min-width:100%;"><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">X-RateLimit-Limit</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Maximum requests per second</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">X-RateLimit-Remaining</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Requests remaining in current window</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">X-RateLimit-Reset</p><p class="slate-p slate-indent-0-1-1-1-1-1" style="NaNpx"></p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Unix timestamp when limit resets</p></td></tr></tbody></table></div></div><h2 class="slate-h2 " >Rate Limit Response</h2><p class="slate-p slate-indent-0" style="0px">When you exceed the rate limit, you&apos;ll receive a <span style="background-color:#D9D9D9;"></span><span class="slate-color" style="background-color:#FFFFFF;color:#434343"><code class="slate-code" style="color:#434343">429 Too Many Requests</code></span><span style="background-color:#FFFFFF;"></span> response:</p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden">{
  &quot;error&quot;: &quot;Rate limit exceeded&quot;,
  &quot;code&quot;: &quot;RATE_LIMIT_EXCEEDED&quot;,
  &quot;retry_after&quot;: 1.5
} </textarea><code class="language-plainText keep-markup drop-tokens">{
  &quot;error&quot;: &quot;Rate limit exceeded&quot;,
  &quot;code&quot;: &quot;RATE_LIMIT_EXCEEDED&quot;,
  &quot;retry_after&quot;: 1.5
}</code></pre></div><p class="slate-p slate-indent-0" style="0px">The <span style="background-color:#FFFFFF;"><code class="slate-code">Retry-After</code></span>header indicates seconds to wait:</p><p class="slate-p " ><code class="slate-code">Retry-After: 1.5</code></p><h2 class="slate-h2 " >Endpoint-Specific Limits</h2><p class="slate-p slate-indent-0" style="0px">Some endpoints have additional limits:</p><p class="slate-p " ></p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><div class="published-table-header" style="width:100%;min-width:100%;"><div >Title</div><div >Description</div><div >Title</div></div><table class="slate-table" style="min-width:100%;"><colgroup ><col style="width:initial"><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">POST /outbound-calls</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">
10/sec</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Per organization</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">POST /phone-numbers</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">5/sec</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">KYC required</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">GET /calls</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">100/sec</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Pagination recommended</p></td></tr><tr class="slate-tr " ><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">POST /webhooks</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">
10/sec</p></td><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Per organization</p></td></tr></tbody></table></div></div><p class="slate-p " ></p>

Sections

REFERENCE

On this page

Sections

REFERENCE

On this page

Ask an AI

Code with AI