---
title: "Update Organization Links"
method: PUT
path: "/admin/organizations/{organization_id}/links"
tags: ["admin", "organizations"]
---

# Update Organization Links

`PUT /admin/organizations/{organization_id}/links`

## Request

- Base URL: `https://api-docs.upsmith.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.upsmith.com/admin/organizations/{organization_id}/links`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Set, correct or clear which record in each external system this organization is.

An omitted field is left alone; an explicit ``null`` clears the link. Setting one locks
that source by default, because the matcher runs hourly and would otherwise revert the
correction on its next pass.

## Path parameters

- `organization_id` string, required

## Headers

- `organization-id` string, nullable
- `timezone` string
- `x-user-id` string, nullable
- `x-actor-email` string, nullable
- `x-request-source` string, nullable
- `x-operation-id` string, nullable
- `x-commit-message` string, nullable
- `x-confirmation-id` string, nullable
- `x-chat-id` string, nullable

## Request body

- UpdateOrganizationLinksRequest: Which record in each external system this organization is. Kept off ``UpdateOrganizationRequest`` on purpose. That one is reachable by a customer's own admin; deciding which Linear customer or HubSpot company an organization *is* is an internal decision, and propagation writes outward from it. An omitted field is left alone; an explicit ``null`` clears the link — callers read the difference off ``model_fields_set``, so clearing a wrong link is expressible. That is the common correction, not an edge case.
  - `domains` string[], nullable
  - `ops_owner_user_id` string, nullable
  - `linear_customer_id` string, nullable
  - `hubspot_company_id` string, nullable
  - `plain_tenant_id` string, nullable
  - `plain_company_id` string, nullable
  - `slack_user_group_id` string, nullable
  - `sync_locked_sources` string[], nullable
  - `lock` boolean

## Response `200`

Successful Response

- Organization

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/upsmith/apis/upsmith-api.md) - [All operations](https://skmtc.dev/upsmith/apis/upsmith-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upsmith/apis/upsmith-api/revisions/86e2c2bd93af?raw)