Private API (existing keys)

Reference for API keys created before the Private API was retired.

Raqi no longer creates new API keys. To work with Raqi from your own tools, use the MCP server. A key created before keeps working on the Business plan, and this page stays as its reference: it reads contacts, conversations and agents, and adds new contacts, through REST endpoints.

Managing an Existing Key

Open Integrations & API. A workspace with a key sees Private API key under the MCP server card. Manage shows its status, Regenerate key replaces it (the new key starts with rq_live_ and is shown only once), and Disconnect turns it off.

Important: Raqi stores only a SHA-256 hash of your key, never the key itself. Regenerating a key needs the Business plan, and the old key stops working at once.

Authentication

Send the key as a Bearer token in the Authorization header of every request:

bash

curl -H "Authorization: Bearer rq_live_your_api_key_here" \
  https://api.raqi.io/api/v1/ping

Available Endpoints

All endpoints are scoped to your workspace and return JSON:

Method	Endpoint	Description
GET	/v1/ping	Health check that returns your workspace ID
GET	/v1/contacts	List contacts (supports ?search=, ?page=, ?limit=)
GET	/v1/contacts/:id	Get a single contact by ID
POST	/v1/contacts	Create a new contact
GET	/v1/conversations	List conversations (supports ?status=, ?page=, ?limit=)
GET	/v1/conversations/:id/messages	Get messages in a conversation
GET	/v1/agents	List AI agents
GET	/v1/workspace	Workspace info with contact, conversation and agent counts

Rate Limits

The API allows 100 requests per minute per IP address. Above that you receive a 429 (Too Many Requests) response.

Code Examples

Create a contact via the API:

bash

curl -X POST \
  -H "Authorization: Bearer rq_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ahmed", "email": "ahmed@example.com", "phone": "+966501234567", "tags": ["website"]}' \
  https://api.raqi.io/api/v1/contacts

For New Projects

Build new connections on the MCP server. Claude, ChatGPT, Manus and other MCP clients sign in with OAuth and work in the same workspace scope, with no API key to manage.

Was this article helpful?

Integrations & API