List project members for reviewer routing

v1.0.0

Return the people who can review work on this project — one row per member with access to it, each with their user_uuid, email, first_name/last_name, and resolved GitHub login (null when they have no linked GitHub identity). The cold-start reviewer-routing path: when a finding's owner can't be read off a fetched entity's created_by and there's no cached reviewer:<area> memory or inbox precedent, list members, match the owner by email/name, then put their resolved github_login in suggested_reviewers on emit-report / edit-report. Pass search to narrow a large roster; the result is capped at 200. Strictly team-scoped.

Input

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string"
    },
    "search": {
      "type": "string"
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "array",
  "items": {
    "type": "object",
    "description": "One project member's routing identity, for picking a `suggested_reviewers` entry on a report.",
    "required": [
      "email",
      "first_name",
      "github_login",
      "last_name",
      "user_uuid"
    ],
    "properties": {
      "email": {
        "type": "string",
        "format": "email",
        "description": "The member's email — use to match a finding's owner by name/email."
      },
      "first_name": {
        "type": "string",
        "description": "The member's first name (may be empty)."
      },
      "github_login": {
        "type": [
          "string",
          "null"
        ],
        "description": "The member's resolved GitHub login (lowercased), already resolved server-side. Null when the member has no linked GitHub account, which does not stop you routing to them: pass their `user_uuid` in `suggested_reviewers` and the report reaches them. A null login only means no draft PR can be opened as that person."
      },
      "last_name": {
        "type": "string",
        "description": "The member's last name (may be empty)."
      },
      "user_uuid": {
        "type": "string",
        "description": "The member's stable PostHog user UUID — the same id that appears as `created_by.uuid` on entities they own. A durable handle for this person across runs."
      }
    }
  }
}