Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.adrian.secureagentics.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Secureagentics REST API gives you full programmatic control over your AI agent security and governance workflows. You can register and manage agents, stream activity events for real-time monitoring, enforce security policies, configure alert channels, and query immutable audit logs — all over HTTPS using standard JSON requests.

​
Base URL

All API requests are made to the following base URL: 
https://api.secureagentics.ai/v1

​
Authentication

Every request must include your API key in the Authorization header: 
Authorization: Bearer YOUR_API_KEY
You can generate and manage API keys from the Settings → API Keys page in your Secureagentics dashboard.
Never expose your API key in client-side code, public repositories, or logs. Use environment variables to store keys securely.

​
Content type

All request bodies must be JSON. Include the following header on every POST or PATCH request: 
Content-Type: application/json

​
Endpoints

The table below lists all available endpoints.
MethodPathDescription
POST/v1/agentsRegister a new agent
GET/v1/agentsList all agents
GET/v1/agents/{id}Get a single agent
DELETE/v1/agents/{id}Delete an agent
POST/v1/agents/{id}/eventsSend an event for an agent
GET/v1/agents/{id}/eventsList events for an agent
POST/v1/agents/{id}/events/batchSend multiple events at once
POST/v1/policiesCreate a security policy
GET/v1/policiesList all policies
DELETE/v1/policies/{id}Delete a policy
POST/v1/alertsCreate an alert
GET/v1/alertsList all alerts
DELETE/v1/alerts/{id}Delete an alert
GET/v1/audit-logsList audit log entries

​
Rate limits

The API allows up to 1,000 requests per minute per API key. If you exceed this limit, the API returns a 429 Too Many Requests response. Wait until the next minute window before retrying.
Use the batch events endpoint (POST /v1/agents/{id}/events/batch) to send up to 100 events in a single request and reduce your per-minute request count.

​
Error responses

All errors follow a consistent JSON structure: 
{
  "error": {
    "code": "not_found",
    "message": "Agent not found",
    "status": 404
  }
}
StatusCodeDescription
400bad_requestThe request body or parameters are malformed or missing required fields.
401unauthorizedThe API key is missing or invalid.
403forbiddenThe API key does not have sufficient scope for this operation.
404not_foundThe requested resource does not exist.
429rate_limit_exceededYou have exceeded the 1,000 requests/minute rate limit.
500internal_errorAn unexpected server error occurred. Contact support if this persists.