---
title: "Update a Stakeholder"
method: PATCH
path: "/v2/accounts/{account_id}/stakeholders/{stakeholder_id}"
tags: ["Linked Accounts", "Partner Stakeholders"]
---

# Update a Stakeholder

`PATCH /v2/accounts/{account_id}/stakeholders/{stakeholder_id}`

## Request

- Base URL: `https://api.razorpay.com/v1`
- URL: `https://api.razorpay.com/v1/v2/accounts/{account_id}/stakeholders/{stakeholder_id}`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://mcp.razorpay.com/authorize`
    - Client credentials
    - Token URL: `https://mcp.razorpay.com/token` scopes: `read_only`
- TypeScript: <https://skmtc.dev/razorpay/apis/razorpay-api/docs/v2/accounts/:account_id/stakeholders/:stakeholder_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update stakeholder information for a Linked Account.

## Path parameters

- `account_id` string, required
- `stakeholder_id` string, required

## Request body

- object
  - `name` string
  - `percentage_ownership` number
  - `relationship` object
  - `phone` object
  - `addresses` object
  - `kyc` object
  - `notes` Notes: Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

## Response `200`

Stakeholder updated.

- Stakeholder: A business owner or director associated with a Linked Account. Only one stakeholder is allowed per Route Linked Account. Prefix: sth_
  - `id` string: Stakeholder ID. Prefix: sth_
  - `entity` 'stakeholder'
  - `name` string: Full name of the stakeholder.
  - `email` string: Email address.
  - `percentage_ownership` number: Ownership percentage (0-100).
  - `relationship` object
    - `director` boolean: True if the stakeholder is a company director.
    - `executive` boolean: True if the stakeholder is an executive.
  - `phone` object
    - `primary` object
      - `number` string
      - `country_code` string
    - `secondary` object
      - `number` string
      - `country_code` string
  - `addresses` object
    - `residential` object
      - `street` string
      - `city` string
      - `state` string
      - `postal_code` string
      - `country` string
  - `kyc` object
    - `pan` string: Individual PAN. 4th character must be 'P'.
  - `notes` Notes: Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.
  - `created_at` integer

## Other responses

- `400`: Bad request. Invalid parameters or missing required fields.
- `401`: Authentication failed. Invalid or missing API key credentials.
- `404`: Resource not found.
- `429`: Rate limit exceeded. Implement exponential backoff with jitter before retrying.

---

[API](https://skmtc.dev/razorpay/apis/razorpay-api.md) - [All operations](https://skmtc.dev/razorpay/apis/razorpay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/razorpay/apis/razorpay-api/revisions/824ca9e6faef?raw)