---
updatedAt: 2026-06-30T19:02:30.000Z
agentTools:
  projectIndex: https://docs.cfx.to/llms.txt
---

# Update a ledger account of an organization

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Organization API",
    "description": "Interact with Organizations",
    "termsOfService": "",
    "contact": {
      "name": "API Owner",
      "email": "api@cfxlabs.com"
    },
    "license": {
      "name": "",
      "url": ""
    },
    "version": "@VERSION@",
    "summary": "CFX Organization API"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "name": "x-api-key",
        "type": "apiKey",
        "in": "header"
      },
      "ApiSecretAuth": {
        "name": "x-api-secret",
        "type": "apiKey",
        "in": "header"
      }
    }
  },
  "paths": {
    "/v1/organization/{organizationId}/ledger-accounts/{id}": {
      "put": {
        "summary": "Update a ledger account of an organization",
        "tags": [
          "Ledger Accounts"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "referenceId": {
                    "type": "string",
                    "description": "Customer's reference ID for this account"
                  },
                  "name": {
                    "type": "string",
                    "description": "Human-readable label for this account"
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "example": "redwal_xxxxxxxx",
            "in": "path",
            "name": "id",
            "required": true,
            "description": "The unique identifier for the account"
          },
          {
            "schema": {
              "type": "string"
            },
            "example": "org_xxxxxxxxxx",
            "in": "path",
            "name": "organizationId",
            "required": true,
            "description": "The unique identifier for the organization that owns the account"
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id",
                    "balance",
                    "address",
                    "visibility",
                    "createdAt",
                    "updatedAt"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique identifier for a ledger account, in `redwal_...` format",
                      "example": "redwal_xxxxxxxx"
                    },
                    "referenceId": {
                      "type": "string",
                      "description": "Customer's reference ID for this account"
                    },
                    "balance": {
                      "type": "string",
                      "description": "The balance of the ledger account"
                    },
                    "name": {
                      "type": "string",
                      "description": "Human-readable label for this account"
                    },
                    "address": {
                      "type": "string",
                      "description": "Base-58 address to the underlying Solana account"
                    },
                    "visibility": {
                      "enum": [
                        "PRIVATE",
                        "PUBLIC"
                      ],
                      "type": "string",
                      "description": "Visibility of the account across MoveUSD network. **WARNING: `PUBLIC` wallets are visible to all customers.**"
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "description": "The timestamp of when this account was created"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "description": "The timestamp of when this account was last updated"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "code",
                    "message"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "INVALID_REQUEST",
                        "INVALID_ORGANIZATION"
                      ],
                      "description": "- `INVALID_REQUEST`: The service cannot understand the request\n- `INVALID_ORGANIZATION`: The organization is not allowed to update a ledger account"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": true
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "The access to this resource has been denied",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "code",
                    "message"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "UNAUTHORIZED"
                      ]
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "title": "UNAUTHORIZED",
                  "description": "The access to this resource has been denied"
                }
              }
            }
          },
          "403": {
            "description": "The credentials are valid but the caller is not permitted to transact",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "code",
                    "message"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "FORBIDDEN"
                      ]
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "title": "FORBIDDEN",
                  "description": "The credentials are valid but the caller is not permitted to transact"
                }
              }
            }
          },
          "404": {
            "description": "The resource was not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "code",
                    "message"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "NOT_FOUND"
                      ]
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "title": "NOT_FOUND",
                  "description": "The resource was not found"
                }
              }
            }
          },
          "default": {
            "description": "Catch-all error response for any unexpected internal errors",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "code",
                    "message"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "INTERNAL"
                      ]
                    },
                    "message": {
                      "type": "string",
                      "enum": [
                        "An unexpected internal error has occurred"
                      ]
                    }
                  },
                  "title": "INTERNAL",
                  "description": "Catch-all error response for any unexpected internal errors"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.dev.cfx.to",
      "description": "Customer Sandbox"
    },
    {
      "url": "https://api.cfx.to",
      "description": "Production"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": [],
      "ApiSecretAuth": []
    }
  ],
  "tags": [
    {
      "name": "Ledger Accounts",
      "description": "MoveUSD-denominated accounts owned by an organization."
    }
  ],
  "externalDocs": {
    "description": "Find out more about CFX",
    "url": "https://www.cfxlabs.com/"
  }
}
```