v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB

enterprise-admin

Create or update organization custom property definitions on an enterprise

Creates new or updates existing organization custom properties defined on an enterprise in a batch.

If the property already exists, the existing property will be replaced with the new values. Missing optional values will fall back to default values, previous values will be overwritten.

Access requirements:

Enterprise admins
OAuth tokens and personal access tokens (classic) with the admin:enterprise scope
Actors with the enterprise-level "manage enterprise custom properties for organizations" fine-grained permission

patch/enterprises/{enterprise}/org-properties/schema

Path parameters

enterprisestring required

The slug version of the enterprise name.

Request body

Example request

{
  "properties": [
    {
      "source_type": "organization",
      "value_type": "single_select",
      "values_editable_by": "enterprise_actors"
    }
  ]
}

Response

property_namestring required

The name of the property

urlstring uri

The URL that can be used to fetch, update, or delete info about this property via the API.

source_type'organization' | 'enterprise'

The source type of the property

value_type'string' | 'single_select' | 'multi_select' | 'true_false' | 'url' required

The type of the value for the property

requiredboolean

Whether the property is required.

descriptionstring nullable

Short description of the property

allowed_valuesstring[] nullable

An ordered list of the allowed values of the property. The property can have up to 200 allowed values.

values_editable_by'enterprise_actors' | 'enterprise_and_org_actors' nullable

Who can edit the values of the property

Example response

[
  {
    "source_type": "organization",
    "value_type": "single_select",
    "values_editable_by": "enterprise_actors"
  }
]