---
title: "Assign a role to a member"
method: POST
path: "/identity/members/{id}/role"
tags: ["identity", "members", "business", "customer-session"]
---

# Assign a role to a member

`POST /identity/members/{id}/role`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/identity/members/{id}/role`
- Auth: none declared. Required headers: `Idempotency-Key`

Commits a reviewed member role assignment with fresh factor proof and an Idempotency-Key. Returns the original operation receipt on retry without spending proof again or reading a newer role. Fresh changes require current roles_manage in an enforced business.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- MembersroleAssignmentSaveInput
  - `expected_revision` string, required
  - `passkey` string
  - `proof` string
  - `role_key` string, required
  - `role_kind` 'preset' | 'custom', required

## Response `200`

OK

- AccessReceiptOutput
  - `outcome` 'committed' | 'refused' | 'unknown', required
  - `result` AccessReceiptDetailsOutput
    - `committed_ts` string, date-time, required
    - `operation_id` string, required
    - `resulting_role_revision` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `default`: Error response.

## Changes

- **2026-11-20** `f240ce7a9650`: 3 breaking, 4 info
  - added the new required `header` request parameter `Idempotency-Key`
  - removed the required property `assignment_revision` from the response with the `200` status
  - removed the required property `role` from the response with the `200` status
  - added the new optional request property `passkey`
  - …3 more
- **2026-11-19** `aa2e3c3161d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/identity/members/:id/role/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/f240ce7a9650?raw)
