{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.","properties":{"path":{"type":"object","properties":{"org":{"type":"string","description":"The organization name. The name is not case sensitive."}},"required":["org"],"additionalProperties":false},"body":{"type":"object","properties":{"properties":{"type":"array","description":"The array of custom properties to create or update.","items":{"$ref":"#/definitions/custom-property"},"minItems":1,"maxItems":100}},"required":["properties"],"examples":[{"properties":[{"property_name":"environment","value_type":"single_select","required":true,"default_value":"production","description":"Prod or dev environment","allowed_values":["production","development"],"values_editable_by":"org_actors"},{"property_name":"service","value_type":"string"},{"property_name":"team","value_type":"string","description":"Team owning the repository"}]}]}},"required":["path","body"],"additionalProperties":false,"definitions":{"custom-property":{"title":"Organization Custom Property","description":"Custom property defined on an organization","type":"object","properties":{"property_name":{"type":"string","description":"The name of the property"},"url":{"type":"string","format":"uri","description":"The URL that can be used to fetch, update, or delete info about this property via the API."},"source_type":{"type":"string","description":"The source type of the property","enum":["organization","enterprise"],"examples":["organization"]},"value_type":{"type":"string","enum":["string","single_select","multi_select","true_false","url"],"description":"The type of the value for the property","examples":["single_select"]},"required":{"type":"boolean","description":"Whether the property is required."},"default_value":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Default value of the property"},"description":{"type":["string","null"],"description":"Short description of the property"},"allowed_values":{"type":["array","null"],"items":{"type":"string"},"description":"An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."},"values_editable_by":{"type":["string","null"],"enum":["org_actors","org_and_repo_actors"],"description":"Who can edit the values of the property","examples":["org_actors"]},"require_explicit_values":{"type":"boolean","description":"Whether setting properties values is mandatory"}},"required":["property_name","value_type"]}}},"name":"Create or update custom properties for an organization","id":"github.orgs.custom-properties-for-repos-create-or-update-organization-ed341b3e2b","example":{"path":{"org":"example"},"body":{"properties":[{"property_name":"environment","value_type":"single_select","required":true,"default_value":"production","description":"Prod or dev environment","allowed_values":["production","development"],"values_editable_by":"org_actors"},{"property_name":"service","value_type":"string"},{"property_name":"team","value_type":"string","description":"Team owning the repository"}]}},"maxRequests":1,"summary":false}}