AI Agent API Documentation

Introduction

Runexa AI infrastructure

Runexa API allows developers and enterprises to integrate advanced AI analysis workflows directly into products, dashboards, internal tools, and enterprise systems.

https://api.runexa.ai

Local:
http://127.0.0.1:8000

Authentication

All API requests require a bearer API key.

Authorization: Bearer rk_live_xxxxxxxxx

curl -X GET "http://127.0.0.1:8000/v1/test-api-key" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx"

Async Architecture

Runexa APIs use asynchronous AI processing powered by queue-based workers.

Frontend
→ Runexa API
→ Job Queue
→ AI Workers
→ Persistent Storage
→ Async Result Retrieval

curl -X POST "http://127.0.0.1:8000/v1/finance/analyze" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx" \
  -F "file=@statement.pdf" \
  -F "output_language=en"

{
  "job_id": 9,
  "status": "pending",
  "progress": 0,
  "status_message": "Finance API analysis queued...",
  "credits_used": 7,
  "remaining_api_credits": 88
}

curl -X POST "http://127.0.0.1:8000/v1/legal/analyze" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx" \
  -F "file=@contract.pdf" \
  -F "output_language=en"

{
  "job_id": 10,
  "status": "pending",
  "credits_used": 12,
  "remaining_api_credits": 76
}

curl -X POST "http://127.0.0.1:8000/v1/business/analyze" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx" \
  -F "file=@business.xlsx" \
  -F "output_language=en"

{
  "job_id": 13,
  "status": "pending",
  "credits_used": 30,
  "remaining_api_credits": 22
}

Jobs API

Retrieve asynchronous AI analysis results.

GET /v1/jobs/{job_id}

{
  "id": 15,
  "status": "completed",
  "progress": 100,
  "result": {}
}

Error Responses

Rate Limits