API Reference

RESTful API for managing agents programmatically.

Base URL: https://api.maritime.sh/v1

All requests require an Authorization: Bearer <token> header.

List Agents

GET /api/agents

Response:
{
  "agents": [
    {
      "id": "agent_abc123",
      "name": "support-bot",
      "framework": "crewai",
      "tier": "smart",
      "status": "sleeping",
      "invocation_count": 847
    }
  ]
}

Create Agent

POST /api/agents

Body:
{
  "name": "my-agent",
  "framework": "crewai",
  "tier": "smart",
  "github_repo": "owner/repo"
}

Response: 201 Created
{ "id": "agent_abc123", "name": "my-agent", ... }

Deploy Agent

POST /api/deploy

Body:
{
  "agent_id": "agent_abc123",
  "source": "github",
  "branch": "main"
}

Response: 202 Accepted
{ "deployment_id": "deploy_xyz789", "status": "pending" }

Invoke Agent (Webhook)

POST /api/webhooks/{agent_id}

Body: (any JSON payload)
{
  "message": "Hello, agent!"
}

Response: 200 OK
{ "result": "...", "wake_time_ms": 230 }