---
updatedAt: 2026-06-24T15:01:46.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# Update administrative division (deprecated)

**DEPRECATED**. Call [Update holiday calendar](ref:update-holiday-calendar) instead. 

This endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.

Update an administrative division.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Platform setup - Divisions",
    "description": "Use administrative divisions to align organization territory with business needs",
    "version": "v1.0",
    "contact": {
      "name": "Pismo Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing"
    }
  ],
  "security": [
    {
      "S2SAuthentication": []
    }
  ],
  "tags": [
    {
      "name": "Administrative divisions V2 (deprecated)",
      "description": "View and manage admin divisions for transaction banking"
    }
  ],
  "components": {
    "schemas": {
      "AdminDivisionExternalID": {
        "type": "string",
        "description": "Client-supplied external ID. It must comply with the rule `^[a-zA-Z0-9-]+$`.",
        "example": "8675309"
      },
      "AdminDivisionID": {
        "type": "integer",
        "description": "Admininistrative division ID",
        "example": 84849
      },
      "AdminDivisionName": {
        "type": "string",
        "description": "Administrative division name",
        "example": "Scotland"
      },
      "AdminDivisionParentID": {
        "type": "integer",
        "description": "Parent ID"
      },
      "AdminDivisionType": {
        "type": "string",
        "description": "Admin division type",
        "enum": [
          "City",
          "State",
          "Country"
        ],
        "example": "State"
      },
      "handler.HTTPError": {
        "description": "Code and error message.",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error code"
          },
          "message": {
            "type": "string",
            "description": "Error message"
          }
        }
      },
      "Metadata": {
        "type": "object",
        "description": "A valid JSON schema as specified in [https://json-schema.org/specification.html](https://json-schema.org/specification.html). Used to register the rules that are used to authorize the transaction.\n\nThis object uses [parameters](https://developers.pismo.io/pismo-docs/docs/posting-transactions-on-holidays#parameters) to specify business rules for holidays. For details, see [Posting Transactions on Holidays](https://developers.pismo.io/pismo-docs/docs/posting-transactions-on-holidays).\n\n**Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).\n"
      },
      "presenter.v2AdministrativeDivisionResponse": {
        "description": "Administrative division response",
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/AdminDivisionID"
          },
          "external_id": {
            "$ref": "#/components/schemas/AdminDivisionExternalID"
          },
          "name": {
            "$ref": "#/components/schemas/AdminDivisionName"
          },
          "parent_id": {
            "$ref": "#/components/schemas/AdminDivisionParentID"
          },
          "type": {
            "$ref": "#/components/schemas/AdminDivisionType"
          },
          "working_days": {
            "$ref": "#/components/schemas/WorkingDays"
          },
          "metadata": {
            "$ref": "#/components/schemas/Metadata"
          }
        }
      },
      "presenter.v2UpdateAdministrativeDivisionRequest": {
        "description": "Data to update an administrative division (transaction banking)",
        "type": "object",
        "properties": {
          "name": {
            "$ref": "#/components/schemas/AdminDivisionName"
          },
          "type": {
            "$ref": "#/components/schemas/AdminDivisionType"
          },
          "parent_id": {
            "$ref": "#/components/schemas/AdminDivisionParentID"
          },
          "external_id": {
            "$ref": "#/components/schemas/AdminDivisionExternalID"
          },
          "working_days": {
            "$ref": "#/components/schemas/WorkingDays"
          },
          "metadata": {
            "$ref": "#/components/schemas/Metadata"
          }
        }
      },
      "WorkingDays": {
        "type": "array",
        "description": "Week days that are working days where `0` = Sunday and `6` = Saturday. The default - [1,2,3,4,5] - corresponds to Monday through Friday.\n",
        "items": {
          "type": "integer"
        },
        "example": [
          1,
          2,
          3,
          4,
          5
        ]
      }
    },
    "responses": {
      "401UnauthorizedError": {
        "description": "Access token is missing or invalid",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            }
          }
        }
      },
      "500InternalServerError": {
        "description": "Internal server error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "S2SAuthentication": {
        "type": "http",
        "scheme": "bearer",
        "description": "All requests must be previously authenticated with an account token."
      }
    },
    "examples": {
      "MissingTenantResponse": {
        "value": {
          "code": "400",
          "message": "Missing x-tenant header"
        }
      },
      "InvalidParamsResponse": {
        "value": {
          "code": "400",
          "message": "Invalid {parameter_name} parameter value"
        }
      },
      "HierarchyLoopResponse": {
        "value": {
          "code": "400",
          "message": "The parent_id {parent_id} causes a circular hierarchy loop with the administrative_division id {id}."
        }
      },
      "NotFoundResponse": {
        "value": {
          "code": "404",
          "message": "{target_name} not found"
        }
      }
    }
  },
  "paths": {
    "/divisions-core/v2/administrative-division/{id}": {
      "put": {
        "summary": "Update administrative division (deprecated)",
        "description": "**DEPRECATED**. Call [Update holiday calendar](https://developers.pismo.io/pismo-docs/reference/update-holiday-calendar) instead. \n\nThis endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.\n\nUpdate an administrative division.\n",
        "operationId": "put-v2-admin-division",
        "deprecated": true,
        "tags": [
          "Administrative divisions V2 (deprecated)"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/presenter.v2UpdateAdministrativeDivisionRequest"
              }
            }
          }
        },
        "parameters": [
          {
            "description": "Administrative division ID.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/presenter.v2AdministrativeDivisionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/handler.HTTPError"
                },
                "examples": {
                  "response-missing-tenant": {
                    "$ref": "#/components/examples/MissingTenantResponse"
                  },
                  "invalid-params-response": {
                    "$ref": "#/components/examples/InvalidParamsResponse"
                  },
                  "hierarchyLoopResponse": {
                    "$ref": "#/components/examples/HierarchyLoopResponse"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401UnauthorizedError"
          },
          "404": {
            "description": "Not found error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/handler.HTTPError"
                },
                "examples": {
                  "not-found-response": {
                    "$ref": "#/components/examples/NotFoundResponse"
                  }
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    }
  }
}
```