Developer Documentation

API Reference

Complete REST API documentation for building integrations and custom applications with 8bit-ai.

RESTful API

Standard HTTP methods and JSON responses

API Keys

Secure authentication with rotating keys

Rate Limiting

1,000 requests/min on Pro, unlimited Enterprise

Webhooks

Real-time event notifications

SDKs Available

JavaScript, Python, Go, Ruby

OpenAPI Spec

Full OpenAPI 3.0 specification available

Base URL

https://api.8bit-ai.com/v1

All API requests should be made to this base URL. Include your API key in the Authorization header.

API Endpoints

Authentication

POST/api/v1/auth/login

Authenticate and get access token

POST/api/v1/auth/refresh

Refresh expired access token

POST/api/v1/auth/logout

Invalidate current session

Workflows

GET/api/v1/workflows

List all workflows

POST/api/v1/workflows

Create new workflow

GET/api/v1/workflows/{id}

Get workflow details

PUT/api/v1/workflows/{id}

Update workflow

DELETE/api/v1/workflows/{id}

Delete workflow

POST/api/v1/workflows/{id}/execute

Trigger workflow execution

AI Agents

GET/api/v1/agents

List all AI agents

POST/api/v1/agents

Create new AI agent

GET/api/v1/agents/{id}

Get agent configuration

PUT/api/v1/agents/{id}

Update agent settings

POST/api/v1/agents/{id}/invoke

Invoke AI agent

Executions

GET/api/v1/executions

List workflow executions

GET/api/v1/executions/{id}

Get execution details

GET/api/v1/executions/{id}/logs

Get execution logs

POST/api/v1/executions/{id}/retry

Retry failed execution

Integrations

GET/api/v1/integrations

List available integrations

GET/api/v1/integrations/{id}

Get integration details

POST/api/v1/connections

Create integration connection

GET/api/v1/connections

List active connections

Code Examples

cURL

curl -X POST https://api.8bit-ai.com/v1/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Onboarding",
    "trigger": "webhook",
    "steps": [...]
  }'

JavaScript

const response = await fetch('https://api.8bit-ai.com/v1/workflows', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Customer Onboarding',
    trigger: 'webhook',
    steps: [...]
  })
});

const workflow = await response.json();

Python

import requests

response = requests.post(
    'https://api.8bit-ai.com/v1/workflows',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Customer Onboarding',
        'trigger': 'webhook',
        'steps': [...]
    }
)

workflow = response.json()