API basics

Usage and credits

What the Texa API counts, how it draws down your prepaid credits, and how to read this month's usage.

Texa Desk is prepaid, like a phone's airtime: your account holds a balance of credits, and what Texa AI does draws it down. The API counts exactly as Texa Desk does, so a reply costs the same whether it went out on WhatsApp or through your app.

What is counted

Meter	Counts
`conversations`	conversations opened with Texa AI in the loop
`messages_in`	customer messages Texa AI read
`ai_replies`	Texa AI's messages sent to customers
`ai_drafts`	Texa AI's drafts shown to people (suggest reply, shadow mode)
`handovers`	conversations Texa AI handed to people
`ai_resolutions`	conversations Texa AI closed as resolved without a person
`actions`	action requests run in your systems
`media_items`, `media_seconds`	voice notes, photos, documents and videos understood; seconds of audio and video transcribed
`voice_minutes`	minutes of Texa AI voice, on the phone and in your app
`sms_segments_out`, `sms_in`	SMS sent and received
`whatsapp_templates`	WhatsApp template messages sent
`campaign_sends`	campaign messages and calls
`research_responses`	completed surveys and interviews
`ask_questions`	questions put to Ask AI, including through MCP
`api_requests`	Texa API requests with a live key
`sandbox_requests`	Texa API requests with a test key: free, up to 2,000 an account a month

Prices per meter are on texadesk.com/pricing and in Texa Desk under Texa AI → Credits and billing.

The sandbox is free so you can build without paying: test keys make up to 2,000 requests an account a month at no charge. Over that, they answer 402 until the next month (ask Texa if you need more while you build).

This month's usage

Shell

curl https://api.texadesk.com/v1/usage -H "Authorization: Bearer $TEXA_API_KEY"

JSON

{"month": "2026-10", "meters": [
  {"meter": "conversations", "description": "conversations opened with the AI in the loop", "quantity": 412},
  {"meter": "ai_replies", "description": "AI messages sent to customers", "quantity": 1830}
]}

Pass month=2026-09 for an earlier month.

When credits run out

The Texa API answers 402 (insufficient_credits) to anything that would be counted. Top up in Texa Desk under Texa AI → Credits and billing, and requests work again at once.

At zero, Texa AI is paused for the account, so conversations on your channels go to your team on the customer's next message. A top-up resumes it by itself (a pause a person set stays).
Warnings go by email to your administrators at 20% and 5% of the credits last added, and at zero.
Credits expire 12 months after the account last added credits; a notice goes 30 days before, and any top-up keeps the whole balance.