API Overview

Complete reference for all PerceptOS API endpoints.

bash

https://api.perceptos.com/v1

Include your API key in the Authorization header:

bash

Authorization: Bearer YOUR_API_KEY

POST/api/v1/process

Process and analyze your data with our AI engine.

Name	Type	Required	Description
input	`string \| object`	Yes	Data to process
model	`string`	No	Model variant (default, advanced, custom)

json

{
  "id": "proc_abc123",
  "status": "completed",
  "result": {},
  "processingTime": 234
}

GET/api/v1/status

Check system status and health.

json

{
  "status": "operational",
  "uptime": 99.99,
  "responseTime": 45,
  "services": {
    "api": "healthy",
    "database": "healthy"
  }
}

POST/api/v1/analytics

Submit custom analytics events.

Name	Type	Required	Description
event	`string`	Yes	Event name
properties	`object`	No	Event properties

json

{
  "success": true,
  "eventId": "evt_xyz789"
}