---
title: "Update an organization"
method: PATCH
path: "/organizations/{id}"
tags: ["Core resources"]
---

# Update an organization

`PATCH /organizations/{id}`

## Path parameters

- `id` string, required — An object id with prefix

## Headers

- `if-match` string, date-time, required — [ETag](https://en.wikipedia.org/wiki/HTTP_ETag) value for [Optimistic Concurrency Control (OCC)](https://en.wikipedia.org/wiki/Optimistic_concurrency_control). Should contain the last known updated_at timestamp in ISO 8601 format.

## Request body

- object
  - `name` string — Non-empty text string
  - `website` string, nullable — The website address of the business
  - `linkedin` string, uri, nullable — The linked-in url of the business
  - `address` object, nullable — The business address
    - `region` string — State, province, prefecture, or region component. For the US and Canada, MUST be 2-letter abbreviation.
    - `country` string, required — ISO 3166-1 alpha-2 country code
    - `formatted` string — Full mailing address, formatted for display or use on a mailing label. This field MAY contain multiple lines, separated by newlines.
    - `street_address` string — Full street address component, which MAY include house number, street name, Post Office Box, and multi-line extended street address information. This field MAY contain multiple lines, separated by newlines.
    - `locality` string — City, town, or locality component.
    - `postal_code` string — Zip code or postal code component.
  - `legal_structure` 'sole_proprietor' | 'single_member_llc' | 'limited_liability_company' | 'general_partnership' | 'unlisted_corporation' | 'publicly_traded_corporation' | 'association' | 'non_profit' | 'government_organization' | 'revocable_trust' | 'irrevocable_trust' | 'estate' | 'null', nullable — The legal structure of the business
  - `industry` string, nullable — The industry of the business
  - `formation_date` string, date, nullable — The formation date of the business
  - `size` '1-24' | '25-99' | '100-499' | '500+' | 'null', nullable — The size of the business based on number of employees or contractors
  - `yc_verified` unknown
  - `advance_for` 'me' | 'my_users' | 'null', nullable — Whether the organization is using advances for retail customers ("me") or as a platform for others ("my_users")
  - `aiprise_business_id` string, nullable — The kyb verification session id
  - `monato_business_id` string, nullable — The monato business id
  - `yc_url` string, nullable — the y combinator verification url

## Response `200`

Successful operation

- object
  - `name` string, required — Non-empty text string
  - `website` string — The website address of the business
  - `linkedin` string, uri — The linked-in url of the business
  - `address` object — The business address
    - `region` string — State, province, prefecture, or region component. For the US and Canada, MUST be 2-letter abbreviation.
    - `country` string, required — ISO 3166-1 alpha-2 country code
    - `formatted` string — Full mailing address, formatted for display or use on a mailing label. This field MAY contain multiple lines, separated by newlines.
    - `street_address` string — Full street address component, which MAY include house number, street name, Post Office Box, and multi-line extended street address information. This field MAY contain multiple lines, separated by newlines.
    - `locality` string — City, town, or locality component.
    - `postal_code` string — Zip code or postal code component.
  - `legal_structure` 'sole_proprietor' | 'single_member_llc' | 'limited_liability_company' | 'general_partnership' | 'unlisted_corporation' | 'publicly_traded_corporation' | 'association' | 'non_profit' | 'government_organization' | 'revocable_trust' | 'irrevocable_trust' | 'estate' — The legal structure of the business
  - `industry` string — The industry of the business
  - `formation_date` string, date — The formation date of the business
  - `size` '1-24' | '25-99' | '100-499' | '500+' — The size of the business based on number of employees or contractors
  - `yc_verified` string, date — date on which YC url was verified
  - `advance_for` 'me' | 'my_users' | 'null', nullable — Whether the organization is using advances for retail customers ("me") or as a platform for others ("my_users")
  - `aiprise_business_id` string, nullable — The kyb verification session id
  - `monato_business_id` string, nullable — The monato business id
  - `picture` string, uri, required — The business logo
  - `id` string, required — An object id with prefix
  - `created_at` string, date-time, required — Creation date and time
  - `created_by` string, required — ID of the user that created this object
  - `updated_at` string, date-time, required — Last update date and time
  - `updated_by` string, required — ID of the user that last updated this object

---

[API](https://skmtc.net/sivo/apis/sivo-advance-api.md) · [All operations](https://skmtc.net/sivo/apis/sivo-advance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sivo/sivo-advance-api/versions/bfbcd2bfed61/schema)