Propose updating members

[Admin Only] Creates a proposal to update existing members.

Note: Name changes are applied immediately upon request submission and do not require proposal execution. Only walletAddress changes require the full proposal workflow. Only admin API members can make requests to this endpoint.

POST /members/proposals/update

cURL

cURL

curl --request POST \
  --url https://api.onchainden.com/api/v1/members/proposals/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '
{
  "items": [
    {
      "id": "mem_123",
      "name": "Alice Updated"
    },
    {
      "id": "mem_456",
      "walletAddress": "0xnew..."
    }
  ]
}
'

200

Example

{
  "data": {
    "id": "prop_mem_update_123",
    "resourceType": "members",
    "action": "update",
    "signatureStatus": "approvalReady",
    "executionStatus": "completed",
    "threshold": 2,
    "approvals": [],
    "rejections": [],
    "createdAt": "2026-01-18T00:00:00.000Z",
    "expiresAt": "2026-01-25T00:00:00.000Z",
    "data": {
      "items": [
        {
          "id": "mem_123",
          "name": "Alice Updated"
        },
        {
          "id": "mem_456",
          "walletAddress": "0xnew..."
        }
      ]
    },
    "result": {
      "resolution": "approved",
      "resources": [
        {
          "type": "member",
          "id": "mem_123",
          "uri": "/api/v1/members/mem_123"
        },
        {
          "type": "member",
          "id": "mem_456",
          "uri": "/api/v1/members/mem_456"
        }
      ]
    }
  }
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Headers

X-Idempotency-Key · string<uuid> · required

Idempotency key for safely retrying mutation requests.

Body

application/json

items · object[] · required

List of member updates

Show child attributes

Response

200

application/json

Member update proposal created

data · object · required

Show child attributes

Example:

{
  "id": "prop_mem_update_123",
  "resourceType": "members",
  "action": "update",
  "signatureStatus": "approvalReady",
  "executionStatus": "completed",
  "threshold": 2,
  "approvals": [],
  "rejections": [],
  "createdAt": "2026-01-18T00:00:00.000Z",
  "expiresAt": "2026-01-25T00:00:00.000Z",
  "data": {
    "items": [
      { "id": "mem_123", "name": "Alice Updated" },
      {
        "id": "mem_456",
        "walletAddress": "0xnew..."
      }
    ]
  },
  "result": {
    "resolution": "approved",
    "resources": [
      {
        "type": "member",
        "id": "mem_123",
        "uri": "/api/v1/members/mem_123"
      },
      {
        "type": "member",
        "id": "mem_456",
        "uri": "/api/v1/members/mem_456"
      }
    ]
  }
}