Creates a new structured metadata field in your account
Creates a new metadata field with the specified properties and configuration.
Basic authentication using Cloudinary API Key and API Secret.
In: header
Path Parameters
The cloud name of your product environment.
Request Body
application/json
The metadata field definition.
The type of the metadata field.
Value in
- "string"
- "integer"
- "date"
- "enum"
- "set"
The external ID of the metadata field.
length <= 255The label of the metadata field.
length <= 255Whether the metadata field is mandatory.
The default value of the metadata field.
Whether the field is disabled in the UI by default.
The validation defined for the metadata field.
Controls UI visibility and editability of the field. All three keys are always returned; any omitted key on input defaults to false.
The group used to organize this metadata field into a collapsible section in the UI. Defaults to "default". Purely presentational — it does not affect rules, search, or value validation.
The datasource defined for the metadata field.
Whether the metadata field allows adding new options to the datasource dynamically.
Whether datasource values are maintained in case-insensitive alphabetical order. When true, values are automatically sorted on insert and update. Default false.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1_1/my_cloud/metadata_fields" \ -H "Content-Type: application/json" \ -d '{}'{ "type": "string", "external_id": "string", "label": "string", "mandatory": true, "default_value": "string", "default_disabled": true, "validation": {}, "restrictions": { "readonly_ui": true, "hidden_ui": true, "excluded_from_search": true }, "group": "string", "datasource": { "values": [ { "external_id": "string", "value": "string", "position": 0, "state": "active" } ] }, "allow_dynamic_list_values": true, "alphabetically_sorted": true}Lists all structured metadata fields defined in your Cloudinary product environment GET
Retrieves a list of all metadata fields in the product environment based on the provided filters.
Retrieves the definition of a specific structured metadata field by its identifier (external_id) GET
Retrieves detailed information about the specified metadata field.