---
title: "Update organization"
method: PATCH
path: "/orgs-core/v1/orgs"
tags: ["Orgs"]
---

# Update organization

`PATCH /orgs-core/v1/orgs`

Performs a partial update of an organization's information. Fields not passed are not updated.

## Headers

- `x-tenant` string, required

## Request body

- PatchOrgRequest — Organization data to update
  - `official_name` string — Your company's legal name
  - `org_name` string — Organization display name on the Pismo platform
  - `start_date` string, date — Date to start applying the benchmark rate in the accrual process. Format = YYYY-MM-DD.
  - `expiration_date` string — Card expiration date (format = yymm). If passed, the card expiration date is not calculated using the "Card expiration (# of months)" program parameter.
  - `document_number` string — Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.
  - `address` string — Your company's street name
  - `number` integer — Address number with numeric characters only
  - `complementary_address` string — Any additional information such as suite, apt., and so on.
  - `neighborhood` string — Address neighborhood. Some countries use neighborhood in addresses.
  - `zipcode` string — Cardholder postal code
  - `city` string — Address city
  - `state` '' | 'BLOCKED' | 'UNBLOCKED' — Is card blocked or not in the network brand? When the state is empty, it means the network brand did not successfully receive any action.
  - `country` string — Address country
  - `legal_proxy_name` string — Name of your organization's legal representative (person or other entity)
  - `responsible` string — Email of person at organization who can be contacted if necessary.
  - `currency_numeric_code` string — Numeric code (ISO 4217) for the currency used by the program.<br> `minLength: 3` `maxLength: 3`
  - `timezone` string — Division timezone in timezone database format.<br> This value is used in the calculations for holidays, weekends, and daily balances. If a timezone is not specified, the division inherits the timezone from its parent division. If the parent division also lacks a specified timezone, Pismo defaults to using UTC. To clear this field, specify an empty string.
  - `language` 'en-US' | 'pt-BR' — Language. Default is `en-US`
  - `country_code` string — <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3" target="_blank">ISO 3166 Alpha-3</a> program country code. For example, `BRA` = Brazil.
  - `cycle_closing` string — Cycle closing time. Format = HH:MM:SS
  - `holiday_calendar_id` number — Holiday calendar ID.

## Response `200`

Org data

- OrgDetails — Organization details
  - `id` string — Organization ID
  - `official_name` string — Your company's legal name
  - `org_name` string — Organization display name on the Pismo platform
  - `start_date` string, date — Date to start applying the benchmark rate in the accrual process. Format = YYYY-MM-DD.
  - `expiration_date` string — Card expiration date (format = yymm). If passed, the card expiration date is not calculated using the "Card expiration (# of months)" program parameter.
  - `document_number` string — Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.
  - `address` string — Your company's street name
  - `number` integer — Address number with numeric characters only
  - `complementary_address` string — Any additional information such as suite, apt., and so on.
  - `neighborhood` string — Address neighborhood. Some countries use neighborhood in addresses.
  - `zipcode` string — Cardholder postal code
  - `city` string — Address city
  - `state` '' | 'BLOCKED' | 'UNBLOCKED' — Is card blocked or not in the network brand? When the state is empty, it means the network brand did not successfully receive any action.
  - `country` string — Address country
  - `legal_proxy_name` string — Name of your organization's legal representative (person or other entity)
  - `legal_proxy_document` string — ID (such as a government tax ID number) of your organization's legal representative
  - `responsible` string — Email of person at organization who can be contacted if necessary.
  - `currency_numeric_code` string — Numeric code (ISO 4217) for the currency used by the program.<br> `minLength: 3` `maxLength: 3`
  - `timezone` string — Division timezone in timezone database format.<br> This value is used in the calculations for holidays, weekends, and daily balances. If a timezone is not specified, the division inherits the timezone from its parent division. If the parent division also lacks a specified timezone, Pismo defaults to using UTC. To clear this field, specify an empty string.
  - `language` 'en-US' | 'pt-BR' — Language. Default is `en-US`
  - `country_code` string — <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3" target="_blank">ISO 3166 Alpha-3</a> program country code. For example, `BRA` = Brazil.
  - `cycle_closing` string — Cycle closing time. Format = HH:MM:SS
  - `holiday_calendar_id` number — Holiday calendar ID.

## Other responses

- `400` — Bad Request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)