People

The people in your organization and their job roles.

GET/v1/people

List people

Active people in the organization with their role, job title, manager and teams. Up to 200; use search to narrow.

Needs people:readMCP tool list_people

Query parameters

  • searchstring or null

    Part of a name, job title or team name

Response

  • datalist of PersonRequired
curl "https://developers.playbookops.ai/v1/people" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
Response · 200
{
  "data": [
    {
      "id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
      "name": "Ana Ruiz",
      "email": "ana@example.com",
      "job_title": "Operations lead",
      "role": "member",
      "manager_name": "Bea Okafor",
      "teams": []
    }
  ]
}
GET/v1/job-roles

List job roles

The organization's job roles (the accountability chart), who holds each and how many responsibilities it has.

Needs people:readMCP tool list_job_roles

Response

  • datalist of JobRoleRequired
curl "https://developers.playbookops.ai/v1/job-roles" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
Response · 200
{
  "data": [
    {
      "id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
      "name": "Ana Ruiz",
      "description": "Confirm the date and ask about parking.",
      "holders": [],
      "responsibility_count": 0
    }
  ]
}