PUT /orgs/{org}/properties/schema/{custom_property_name}

Creates a new or updates an existing custom property that is defined for an organization.

To use this endpoint, the authenticated user must be one of:

Servers

Path parameters

Name Type Required Description
custom_property_name String Yes

The custom property name

org String Yes

The organization name. The name is not case sensitive.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
default_value No

Default value of the property

description String No

Short description of the property

required Boolean No

Whether the property is required.

value_type String Yes

The type of the value for the property

Possible values:

  • "string"
  • "multi_select"
  • "true_false"
  • "single_select"
allowed_values[] Array No

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

values_editable_by String No

Who can edit the values of the property

Possible values:

  • "org_and_repo_actors"
  • "org_actors"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.