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.
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.