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:
- An administrator for the organization.
- A user, or a user on a team, with the fine-grained permission of
custom_properties_org_definitions_managerin the organization.
Servers
- https://api.github.com
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 Valid values:
|
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 Valid values:
|
require_explicit_values |
Boolean | No |
Whether setting properties values is mandatory |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.