How it works
The API skill exposes your agent's capabilities programmatically, allowing you to integrate raia into custom applications, mobile apps, or backend services.
Video overview
Key features
RESTful Interface
Standard JSON-based REST API for easy integration.
Thread Management
Create, retrieve, and update conversation threads.
Context Injection
Pass custom variables and metadata along with user messages.
Secure Authentication
Agent-scoped Secret Keys ensure secure access.
How to configure it
- 01
Enable the API skill in Launch Pad.
- 02
Generate a new API Secret Key — store it securely, it is only shown once.
- 03
Review available endpoints (/v1/threads, /v1/messages, etc.) in the Developer Hub.
- 04
Use the base URL and Secret Key in the Authorization: Bearer header of your HTTP requests.
Frequently asked questions
Is there a rate limit on the API?
Yes — standard rate limits apply. Check the Developer Hub for current limits based on your plan.
Can I use the API to update the agent's knowledge base?
The Agent API is for conversation execution. To programmatically update the vector store, use the separate raia Platform API.