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

# Update an organization

`PATCH /organizations/{id}`

## Request

- Base URL: `https://core.sivo.com`
- URL: `https://core.sivo.com/organizations/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://dashboard.sivo.com/oauth/authorize`
    - Client credentials
    - Token URL: `https://core.sivo.com/oauth/token`
- TypeScript: <https://skmtc.dev/sivo/apis/sivo-advance-api/docs/organizations/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

## 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_id` 'no' | 'claimed' | 'null', nullable: Whether the organization says Y Combinator backs it, until YC verifies it
  - `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_id` union: The organization's Y Combinator backing: the id from its verified YC link, or its unverified answer (no or claimed)
    - string
    - 'no' | 'claimed'
  - `aiprise_business_id` string: The AiPrise business profile id
  - `monato_business_id` string: 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

## Changes

- **2026-11-03** `4bbab9699612`: 6 warning, 4 info
  - removed the request property `advance_for`
  - removed the request property `aiprise_business_id`
  - removed the request property `monato_business_id`
  - removed the request property `yc_verified`
  - …6 more

[Operation history](https://skmtc.dev/sivo/apis/sivo-advance-api/changes/organizations/:id/patch.md)

---

[API](https://skmtc.dev/sivo/apis/sivo-advance-api.md) - [All operations](https://skmtc.dev/sivo/apis/sivo-advance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sivo/apis/sivo-advance-api/revisions/4bbab9699612?raw)