Get a stakeholder

curl https://api.example.test/v1/stakeholders/$STAKEHOLDER_ID \  -H "Authorization: Bearer $TOKEN"

One stakeholder. A stakeholder of a project the token may not see is 404 RESOURCE_NOT_FOUND.

side is client, zuse or third_party; role runs sponsor, product_owner, business_owner, subject_matter_expert, end_user_representative, technical_lead, architect, security, legal, finance, operations and other.
influence and interest are low, medium or high; raci_default is responsible, accountable, consulted, informed or null.
email, phone, influence, interest, raci_default, notes and user_id are present for a staff token and absent for a guest's.

Requires ability

stakeholder:view

The token must hold this ability, or the call is refused with 403.

MCP tool

get_stakeholder

Runs the same action from an agent, behind the same ability.

Authorization

bearerToken

AuthorizationBearer <token>

A personal access token minted in the app under Account Settings, then API Tokens, sent as Authorization: Bearer zg_live_…. The token carries the abilities each endpoint lists under Requires ability and is frozen to one team, and optionally to one project, at mint time.

In: header

Path Parameters

stakeholder*string

The stakeholder, bound by the middleware.

Formatuuid

Responses

200OKapplication/json

The stakeholder.

data*

The response's payload.

401UnauthorizedAUTHENTICATION_REQUIREDapplication/json

The request carries no bearer token, or one that is revoked, malformed, or minted for another environment (a zg_test_ token on production).

error*

The one envelope every failure uses.

403ForbiddenTOKEN_MISSING_ABILITYapplication/json

The token is valid but does not carry the ability this endpoint requires; error.context.required_ability names the one to grant. An endpoint that also checks who registered a row answers FORBIDDEN with the same status, and says so in its own description.

error*

The one envelope every failure uses.

404Not foundRESOURCE_NOT_FOUNDapplication/json

An id in the path names nothing the token can see. TENANT_MISMATCH: the project sits outside the token's scope:project: allow-list, or the token carries no team scope. Both answer 404 rather than 403 so that existence outside the token's scope cannot be inferred.

error*

The one envelope every failure uses.

429Too many requestsRATE_LIMITEDapplication/json

The token has spent its 300 requests a minute or 10,000 an hour; Retry-After says when the next one is accepted.

error*

The one envelope every failure uses.

Call it from your code

A sample request in your language, the body each status answers with, and the types to hold them.

curl -X GET "https://example.com/v1/stakeholders/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "data": {    "id": "a7b8c9d0-e1f2-4a3b-8c4d-5e6f7a8b9c01",    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",    "user_id": null,    "name": "Jane Perera",    "email": "jane@acme.example",    "phone": "+94 77 123 4567",    "organisation": "Acme Retail",    "side": "client",    "title": "Head of Digital",    "role": "product_owner",    "influence": "high",    "interest": "high",    "raci_default": "accountable",    "approves_requirements": true,    "signs_off_uat": true,    "approves_releases": false,    "receives_status_reports": true,    "notes": "<p>Prefers a call over email for anything urgent.</p>",    "position": 0,    "created_at": "2026-10-20T09:10:00+00:00",    "updated_at": "2026-10-27T11:30:00+00:00"  }}

Type definitions

The shapes above as types, ready to paste into your client.

export interface Response {  data: StakeholderResource;}export interface StakeholderResource {  id: string;  project_id: string;  user_id?: string | null;  name: string;  email?: string | null;  phone?: string | null;  organisation: string | null;  side: string;  title: string | null;  role: string;  influence?: string;  interest?: string;  raci_default?: string | null;  approves_requirements: boolean;  signs_off_uat: boolean;  approves_releases: boolean;  receives_status_reports: boolean;  notes?: string | null;  position: number;  created_at: string | null;  updated_at: string | null;}

Get a stakeholder

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Path Parameters

Responses