API Reference

Decisio API

Build integrations and automate decisions with our RESTful API.

Base URL

api.decisio.ai/v1

Auth

Bearer Token

Format

JSON

Rate Limit

1000/min

Authentication

All API requests require authentication using a Bearer token. Get your API key from the dashboard under Settings → API Keys.

Authorization: Bearer YOUR_API_KEY
API keys are scoped per tenant. Never share your API key publicly.

Endpoints

Authentication

POST/auth/login
POST/auth/refresh
POST/auth/logout

Agents

GET/agents
GET/agents/{agent_id}
POST/agents/{agent_id}/run
GET/agents/{agent_id}/runs

Decisions

GET/decisions
GET/decisions/{id}
POST/decisions/{id}/approve
POST/decisions/{id}/reject

Products

GET/products
GET/products/{sku}
PATCH/products/{sku}
GET/products/{sku}/history

Integrations

GET/integrations
POST/integrations
POST/integrations/{id}/sync
GET/integrations/{id}/history

Analytics

GET/analytics/dashboard
GET/analytics/revenue
GET/analytics/forecasts
GET/analytics/agent-performance

Code Examples

Run Pricing Agent

bash
curl -X POST https://api.decisio.ai/v1/agents/astra/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_id": "tenant-001",
    "sku": "PROD-001",
    "context": {
      "competitor_prices": [999, 1049, 975],
      "current_inventory": 150
    }
  }'

Get Decisions

javascript
const response = await fetch('https://api.decisio.ai/v1/decisions', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const decisions = await response.json();
console.log(decisions);

Approve Decision

python
import requests

response = requests.post(
    'https://api.decisio.ai/v1/decisions/dec-123/approve',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={'notes': 'Approved after review'}
)

print(response.json())

SDKs & Libraries

JavaScript/Node.js

Available

Python

Available

PHP

Coming Soon

Ruby

Coming Soon

Rate Limits

Starter

100 req/min

Burst: 20 req/sec

Professional

1,000 req/min

Burst: 100 req/sec

Enterprise

Custom

Burst: Custom

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Ready to Build?

Create your free account and get your API key in seconds.

Get API KeyBack to Docs