---
agentTools:
  projectIndex: https://usegraph.readme.io/llms.txt
---

# Update Bank Account

This endpoint can be used to update the status of an account i.e to reactivate or deactivate the account.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Core API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.useoval.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/bank_account/{account_id}": {
      "patch": {
        "summary": "Update Bank Account",
        "description": "This endpoint can be used to update the status of an account i.e to reactivate or deactivate the account.",
        "operationId": "update-account",
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "active",
                      "inactive"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"data\": {\n        \"id\": \"0eaf00acb2d311ef97d00edb5e3a61d3\",\n        \"holder_id\": \"9386ba06b2cd11ef97d00edb5e3a61d3\",\n        \"holder_type\": \"person\",\n        \"label\": \"Collection Account\",\n        \"account_name\": \"TAKESHI KOVACS\",\n        \"account_number\": \"900930224184\",\n        \"routing_number\": \"101019644\",\n        \"iban\": null,\n        \"swift_code\": null,\n        \"check_number\": null,\n        \"bank_name\": \"Bank of Graph\",\n        \"bank_code\": null,\n        \"bank_address\": {\n            \"line1\": \"1801 Main St.\",\n            \"line2\": null,\n            \"city\": \"Jacob City\",\n            \"state\": \"DE\",\n            \"country\": \"US\",\n            \"postal_code\": \"64108\"\n        },\n        \"beneficiary_address\": {\n            \"line1\": \"34 Marka Close\",\n            \"line2\": \"\",\n            \"city\": \"Ikeja\",\n            \"state\": \"Lagos\",\n            \"country\": \"NG\",\n            \"postal_code\": \"100612\"\n        },\n        \"currency\": \"USD\",\n        \"currency_settlement\": \"USD\",\n        \"balance\": 0,\n        \"credit_pending\": 0,\n        \"debit_pending\": 0,\n        \"block_expiry\": null,\n        \"autosweep_enabled\": true,\n        \"whitelist_enabled\": false,\n        \"type\": \"personal_virtual\",\n        \"kind\": \"standard\",\n        \"status\": \"active\",\n        \"status_description\": null,\n        \"is_deleted\": false,\n        \"created_at\": \"2024-12-05T06:35:02Z\",\n        \"updated_at\": \"2025-02-10T06:47:19Z\"\n    },\n    \"message\": \"Account updated successfully\",\n    \"meta\": null,\n    \"status\": \"success\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "0eaf00acb2d311ef97d00edb5e3a61d3"
                        },
                        "holder_id": {
                          "type": "string",
                          "example": "9386ba06b2cd11ef97d00edb5e3a61d3"
                        },
                        "holder_type": {
                          "type": "string",
                          "example": "person"
                        },
                        "label": {
                          "type": "string",
                          "example": "Collection Account"
                        },
                        "account_name": {
                          "type": "string",
                          "example": "TAKESHI KOVACS"
                        },
                        "account_number": {
                          "type": "string",
                          "example": "900930224184"
                        },
                        "routing_number": {
                          "type": "string",
                          "example": "101019644"
                        },
                        "iban": {},
                        "swift_code": {},
                        "check_number": {},
                        "bank_name": {
                          "type": "string",
                          "example": "Bank of Graph"
                        },
                        "bank_code": {},
                        "bank_address": {
                          "type": "object",
                          "properties": {
                            "line1": {
                              "type": "string",
                              "example": "1801 Main St."
                            },
                            "line2": {},
                            "city": {
                              "type": "string",
                              "example": "Jacob City"
                            },
                            "state": {
                              "type": "string",
                              "example": "DE"
                            },
                            "country": {
                              "type": "string",
                              "example": "US"
                            },
                            "postal_code": {
                              "type": "string",
                              "example": "64108"
                            }
                          }
                        },
                        "beneficiary_address": {
                          "type": "object",
                          "properties": {
                            "line1": {
                              "type": "string",
                              "example": "34 Marka Close"
                            },
                            "line2": {
                              "type": "string",
                              "example": ""
                            },
                            "city": {
                              "type": "string",
                              "example": "Ikeja"
                            },
                            "state": {
                              "type": "string",
                              "example": "Lagos"
                            },
                            "country": {
                              "type": "string",
                              "example": "NG"
                            },
                            "postal_code": {
                              "type": "string",
                              "example": "100612"
                            }
                          }
                        },
                        "currency": {
                          "type": "string",
                          "example": "USD"
                        },
                        "currency_settlement": {
                          "type": "string",
                          "example": "USD"
                        },
                        "balance": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        },
                        "credit_pending": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        },
                        "debit_pending": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        },
                        "block_expiry": {},
                        "autosweep_enabled": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "whitelist_enabled": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "type": {
                          "type": "string",
                          "example": "personal_virtual"
                        },
                        "kind": {
                          "type": "string",
                          "example": "standard"
                        },
                        "status": {
                          "type": "string",
                          "example": "active"
                        },
                        "status_description": {},
                        "is_deleted": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "created_at": {
                          "type": "string",
                          "example": "2024-12-05T06:35:02Z"
                        },
                        "updated_at": {
                          "type": "string",
                          "example": "2025-02-10T06:47:19Z"
                        }
                      }
                    },
                    "message": {
                      "type": "string",
                      "example": "Account updated successfully"
                    },
                    "meta": {},
                    "status": {
                      "type": "string",
                      "example": "success"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "637d9e0aeb8873003ad62eac:67af6e4eeb0660001892ad65"
}
```