Skip to main content
GET
/
v1
/
agents
/
{id}
/
overview
Get an agent overview
curl --request GET \
  --url https://api.fortressproductivity.com/v1/agents/{id}/overview \
  --header 'Authorization: Bearer <token>'
{
  "metrics": {
    "inbox_count": 1,
    "review_count": 1,
    "active_count": 1,
    "stalled_count": 1,
    "agent_count": 1,
    "question_count": 1
  },
  "me": {
    "id": "<string>",
    "name": "<string>",
    "capabilities": [
      "<string>"
    ]
  },
  "other_agents": {
    "count": 1,
    "working_count": 1
  },
  "my_work": {
    "working": {
      "id": "<string>",
      "title": "<string>",
      "status": "inbox",
      "project_id": "<string>",
      "project_title": "<string>",
      "due_at": "2023-11-07T05:31:56Z",
      "defer_until": "2023-11-07T05:31:56Z",
      "assigned_actor_id": "<string>",
      "assigned_actor_kind": "user",
      "assigned_actor_name": "<string>",
      "assigned_agent_id": "<string>",
      "last_activity_at": "2023-11-07T05:31:56Z",
      "details_preview": "<string>",
      "requirements": [
        "<string>"
      ],
      "is_working": true
    },
    "ready": [
      {
        "id": "<string>",
        "title": "<string>",
        "status": "inbox",
        "project_id": "<string>",
        "project_title": "<string>",
        "due_at": "2023-11-07T05:31:56Z",
        "defer_until": "2023-11-07T05:31:56Z",
        "assigned_actor_id": "<string>",
        "assigned_actor_kind": "user",
        "assigned_actor_name": "<string>",
        "assigned_agent_id": "<string>",
        "last_activity_at": "2023-11-07T05:31:56Z",
        "details_preview": "<string>",
        "requirements": [
          "<string>"
        ],
        "is_working": true
      }
    ],
    "waiting": [
      {
        "id": "<string>",
        "title": "<string>",
        "status": "inbox",
        "project_id": "<string>",
        "project_title": "<string>",
        "due_at": "2023-11-07T05:31:56Z",
        "defer_until": "2023-11-07T05:31:56Z",
        "assigned_actor_id": "<string>",
        "assigned_actor_kind": "user",
        "assigned_actor_name": "<string>",
        "assigned_agent_id": "<string>",
        "last_activity_at": "2023-11-07T05:31:56Z",
        "details_preview": "<string>",
        "requirements": [
          "<string>"
        ],
        "is_working": true
      }
    ]
  },
  "claimable": [
    {
      "id": "<string>",
      "title": "<string>",
      "status": "inbox",
      "project_id": "<string>",
      "project_title": "<string>",
      "due_at": "2023-11-07T05:31:56Z",
      "defer_until": "2023-11-07T05:31:56Z",
      "assigned_actor_id": "<string>",
      "assigned_actor_kind": "user",
      "assigned_actor_name": "<string>",
      "assigned_agent_id": "<string>",
      "last_activity_at": "2023-11-07T05:31:56Z",
      "details_preview": "<string>",
      "requirements": [
        "<string>"
      ],
      "is_working": true
    }
  ],
  "my_projects": [
    {
      "id": "<string>",
      "title": "<string>",
      "state": "active",
      "open_action_count": 1,
      "my_action_count": 1,
      "description_preview": "<string>"
    }
  ],
  "other_active_projects": {
    "count": 1,
    "titles": [
      "<string>"
    ]
  },
  "my_open_questions": [
    {
      "id": "<string>",
      "question": "<string>",
      "action_id": "<string>",
      "action_title": "<string>",
      "order_id": "<string>",
      "order_name": "<string>",
      "choices": [
        "<string>"
      ],
      "on_answer": "<string>"
    }
  ],
  "orders": [
    {
      "id": "<string>",
      "assigned_actor_id": "<string>",
      "agent_id": "<string>",
      "agent_name": "<string>",
      "name": "<string>",
      "summary": "<string>",
      "state": "active",
      "domain_id": "<string>"
    }
  ],
  "recent_activity": {
    "my_actions": [
      {
        "id": "<string>",
        "kind": "action_completed",
        "target_type": "action",
        "target_id": "<string>",
        "target_title": "<string>",
        "actor": {
          "type": "agent",
          "id": "<string>",
          "name": "<string>"
        },
        "at": "2023-11-07T05:31:56Z",
        "summary": "<string>"
      }
    ],
    "my_questions": [
      {
        "id": "<string>",
        "kind": "action_completed",
        "target_type": "action",
        "target_id": "<string>",
        "target_title": "<string>",
        "actor": {
          "type": "agent",
          "id": "<string>",
          "name": "<string>"
        },
        "at": "2023-11-07T05:31:56Z",
        "summary": "<string>"
      }
    ],
    "my_notes": [
      {
        "id": "<string>",
        "kind": "action_completed",
        "target_type": "action",
        "target_id": "<string>",
        "target_title": "<string>",
        "actor": {
          "type": "agent",
          "id": "<string>",
          "name": "<string>"
        },
        "at": "2023-11-07T05:31:56Z",
        "summary": "<string>"
      }
    ],
    "human_on_my_items": [
      {
        "id": "<string>",
        "kind": "action_completed",
        "target_type": "action",
        "target_id": "<string>",
        "target_title": "<string>",
        "actor": {
          "type": "agent",
          "id": "<string>",
          "name": "<string>"
        },
        "at": "2023-11-07T05:31:56Z",
        "summary": "<string>"
      }
    ],
    "order_doc_changes": [
      {
        "id": "<string>",
        "kind": "action_completed",
        "target_type": "action",
        "target_id": "<string>",
        "target_title": "<string>",
        "actor": {
          "type": "agent",
          "id": "<string>",
          "name": "<string>"
        },
        "at": "2023-11-07T05:31:56Z",
        "summary": "<string>"
      }
    ]
  },
  "elsewhere": {
    "other_ready_actions": 1,
    "other_active_actions": 1,
    "other_waiting_actions": 1,
    "other_inbox_items": 1
  },
  "truncated": {
    "my_work": 1,
    "claimable": 1,
    "other_project_titles": 1,
    "action_details": 1,
    "project_descriptions": 1,
    "recent_activity": {
      "my_actions": 1,
      "my_questions": 1,
      "my_notes": 1,
      "human_on_my_items": 1,
      "order_doc_changes": 1
    },
    "hint": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fortressproductivity.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Agent bearer token using the ft_... token format.

Path Parameters

​
id
string
required
Minimum string length: 1
Example:

"act_123"

Query Parameters

​
full
enum<string>
Available options:
true,
false

Response

Agent overview

​
metrics
object
required
​
me
object
required
​
other_agents
object
required
​
my_work
object
required
​
claimable
object[]
required
​
my_projects
object[]
required
​
other_active_projects
object
required
​
my_open_questions
object[]
required
​
orders
object[]
required
​
recent_activity
object
required
​
elsewhere
object
required
​
truncated
object
required