← myautonomous.ai

API Reference

REST API for MyAutonomous — base URL https://myautonomous.ai. All authenticated endpoints require Authorization: Bearer <token>.

[*] Authentication

POST /api/auth/register

Create a new account. Returns a session token.

curl -X POST https://myautonomous.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com","password":"min-10-chars","org_name":"Acme"}'
# → {"token":"...","user":{...}}
POST /api/auth/login

Log in with email+password. Returns a session token.

curl -X POST https://myautonomous.ai/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com","password":"..."}'
GET /api/auth/oauth/providers

Returns which OAuth providers are configured (Google, GitHub).

curl https://myautonomous.ai/api/auth/oauth/providers
# → {"configured":["google","github"],"unconfigured":[]}

[*] Projects & Missions

POST /api/organizations/{org_id}/projects

Create a project within an organization.

curl -X POST https://myautonomous.ai/api/organizations/$ORG/projects \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"org_id":"...","name":"My Project"}'
POST /api/intents

Describe your goal in plain language. AGENTOS plans the missions.

curl -X POST https://myautonomous.ai/api/intents \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"project_id":"...","text":"Analyze my competitor and give me 3 improvements"}'
POST /api/missions/from-intent

Create a mission from an intent (plans the steps).

curl -X POST https://myautonomous.ai/api/missions/from-intent \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"intent_id":"..."}'
POST /api/missions/{id}/run

Enqueue the mission for async execution. Returns immediately.

curl -X POST https://myautonomous.ai/api/missions/$ID/run \
  -H "Authorization: Bearer $TOKEN"
# → {"queued":true,"state":"PLANNING","mission_id":"..."}
GET /api/missions/{id}

Get mission status, steps, evidence, and loops.

curl https://myautonomous.ai/api/missions/$ID \
  -H "Authorization: Bearer $TOKEN"
# → {"state":"COMPLETED","progress":1.0,"steps":[...],"evidence":[...]}

[*] Public Evidence

GET /api/public/missions/{id}

Read-only view of a publicly shared mission (no auth required). Returns steps and evidence.

curl https://myautonomous.ai/api/public/missions/$PUBLIC_ID
# → {"mission":{"objective":"...","state":"COMPLETED"},"steps":[...],"evidence":[...]}

[*] Pricing & Credits

GET /api/pricing/credits

Your current credit balance and transaction history.

curl https://myautonomous.ai/api/pricing/credits \
  -H "Authorization: Bearer $TOKEN"
# → {"balance":250,"history":[...]}   
GET /api/pricing/subscription

Your current subscription state and plan.

curl https://myautonomous.ai/api/pricing/subscription \
  -H "Authorization: Bearer $TOKEN"
# → {"state":"active","plan":"builder"}

[*] Rate Limits

API: 300 requests/minute per token · Login: 10 attempts/minute · Registration: 10/hour per IP. Exceeded limits return 429 with a retry-after header.

[*] Response Codes

CodeMeaning
200Success
201Created (projects, missions, etc.)
202Accepted for async processing (mission run)
401Missing or invalid token
402Monthly allowance exhausted — upgrade required
403Insufficient permissions
404Not found (or not yours — silent 404 across tenants)
422Validation error
429Rate limit exceeded