HivePA API

Get Archie's current status and a high-level summary of your account.

Response

{
  "success": true,
  "data": {
    "status": "available",
    "active_projects": 3,
    "pending_approvals": 2,
    "unread_messages": 5,
    "summary": "You have 3 active projects. 2 approvals need your attention."
  }
}

Ask Archie a question about your projects, schedule, or account. Archie uses intent classification to route your request appropriately.

Request Body

{
  "message": "Which of my projects need attention today?"
}

Response

{
  "success": true,
  "data": {
    "response": "Two projects need your attention today: \n1. **My App** has 2 pending approvals for the API design.\n2. **Landing Page** has a deliverable ready for review.",
    "actions": [
      { "type": "approval", "project": "My App", "count": 2 },
      { "type": "review", "project": "Landing Page", "count": 1 }
    ]
  }
}

Assign a task to Archie, such as scheduling a review, sending a summary, or coordinating between projects.

Request Body

{
  "task": "Send me a daily summary of all project progress",
  "project_id": null
}

Response

{
  "success": true,
  "data": {
    "task_id": "task_xyz",
    "status": "accepted",
    "message": "I'll send you a daily summary of all project progress. You'll receive it each morning.",
    "scheduled": true
  }
}

Get a PA-curated summary of all projects, organized by priority and attention level.

Response

{
  "success": true,
  "data": {
    "needs_attention": [
      {
        "id": "proj_abc",
        "name": "My App",
        "reason": "2 pending approvals",
        "priority": "high"
      }
    ],
    "on_track": [
      {
        "id": "proj_def",
        "name": "API Service",
        "progress": 72,
        "eta": "2025-02-01"
      }
    ],
    "completed_recently": []
  }
}