Skip to main content
PATCH
Update an organization

Authorizations

Authorization
string
header
required

A workspace API token. Create one in Settings → API. Send it as Authorization: Bearer sk_live_....

Path Parameters

organization_id
string
required

Unique identifier for an organization.

Pattern: ^org_[0-9a-f]{32}$
Example:

"org_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

Query Parameters

expand
string | null

Comma-separated relationships to inline in the response. Unexpanded relations are still identified by their *_id field.

Example:

"organization,owner"

Body

application/json

Body for PATCH /v1/organizations/{organization_id}.

Only the fields you send change. Send null to clear one; omit it to leave it alone. custom_fields merges the same way.

custom_fields
Custom Fields · object | null
name
string | null
owner_id
string | null

Unique identifier for an user.

Pattern: ^usr_[0-9a-f]{32}$
Example:

"usr_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

visibility
enum<string> | null

CRM record visibility levels; resolved live against the owner's current teams.

Available options:
private,
team,
team_and_subteams,
company
website
string | null

Response

Successful Response

A company a contact belongs to.

created_at
string<date-time>
required
id
string
required

Unique identifier for an organization.

Pattern: ^org_[0-9a-f]{32}$
Example:

"org_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

name
string
required
updated_at
string<date-time>
required
visibility
enum<string>
required

Governs who sees this record in the Sailer UI. API tokens are workspace-scoped and are not filtered by it.

Available options:
private,
team,
team_and_subteams,
company
custom_fields
Custom Fields · object

Every custom field defined on organizations in this workspace, keyed by field key and typed from its definition. Unset fields are null, so reading any organization shows the full set of keys in use.

object
string
default:organization
Allowed value: "organization"
owner
Owner · object | null

Whoever is responsible for this record. Always populated when the record has an owner — this is not an expand target.

owner_id
string | null
deprecated

Unique identifier for an user.

Pattern: ^usr_[0-9a-f]{32}$
Example:

"usr_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

tags
Tag · object[]
website
string | null