FIfiles
metadata_categories
Metadata Categories

Create Metadata Category

Changed on

Create Metadata Category

post/metadata_categories

Request

  • Base URL
    https://app.files.com/api/rest/v1
  • URL
    https://app.files.com/api/rest/v1/metadata_categories
  • Auth
    none declared

Request body multipart/form-data

namestring required

Name of the metadata category.

default_columnsstring[]

Metadata keys that should appear as columns in the UI by default.

Example request

{
  "name": "Approval Workflow"
}

Response

The MetadataCategories object.

idinteger

Metadata Category ID

namestring

Name of the metadata category.

definitionsobject

Map of key names to arrays of allowed values. An empty array means free-form text.

default_columnsstring[]

Metadata keys that should appear as columns in the UI by default.

Example response

{
  "id": 1,
  "name": "Approval Workflow",
  "definitions": {
    "Approval Status": [
      "Under Review",
      "Approved",
      "Rejected"
    ],
    "Reviewer": []
  },
  "default_columns": [
    "Approval Status"
  ]
}

Changes