Propose updating accounts

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

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

POST /accounts/proposals/update

cURL

cURL

curl --request POST \
  --url https://api.onchainden.com/api/v1/accounts/proposals/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '
{
  "items": [
    {
      "id": "acc_123",
      "name": "Main Treasury"
    },
    {
      "id": "acc_456",
      "networkIds": [
        42161
      ]
    }
  ]
}
'

200

Example

{
  "data": {
    "id": "prop_acc_update_123",
    "resourceType": "accounts",
    "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": "acc_123",
          "name": "Main Treasury"
        },
        {
          "id": "acc_456",
          "networkIds": [
            42161
          ]
        }
      ]
    },
    "result": {
      "resolution": "approved",
      "resources": [
        {
          "type": "account",
          "id": "acc_123",
          "uri": "/api/v1/accounts/acc_123"
        },
        {
          "type": "account",
          "id": "acc_456",
          "uri": "/api/v1/accounts/acc_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 account updates

Show child attributes

Response

200

application/json

Account update proposal created

data · object · required

Show child attributes

Example:

{
  "id": "prop_acc_update_123",
  "resourceType": "accounts",
  "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": "acc_123", "name": "Main Treasury" },
      { "id": "acc_456", "networkIds": [42161] }
    ]
  },
  "result": {
    "resolution": "approved",
    "resources": [
      {
        "type": "account",
        "id": "acc_123",
        "uri": "/api/v1/accounts/acc_123"
      },
      {
        "type": "account",
        "id": "acc_456",
        "uri": "/api/v1/accounts/acc_456"
      }
    ]
  }
}