Create a metadata descriptor in all projects

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api-docs.kitsu.cloud/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "Kitsu API MCP server": {
    "url": "https://api-docs.kitsu.cloud/mcp"
  }
}

Close
POST /data/metadata-descriptors/all-projects

Create the same metadata descriptor in your projects, in one request. A project that already has a descriptor with this field name is skipped. A metadata descriptor describes an extra column. The values of the column are in the data field of the entities. The route changes the open projects where you are a manager. An administrator changes all the open projects. Your global role must be manager or administrator. The role set on a project does not open this route.

application/json

Body Required

  • entity_type string

    Values are Asset, Shot, Edit, Episode, Sequence, or Project. Default value is Asset.

  • name string Required
  • data_type string

    Default value is string.

  • for_client boolean

    Show the column to the clients

    Default value is false.

  • choices array[string]

    Values of a list column

  • departments array[string(uuid)]

    Departments that see the column

Responses

  • 201

    The new descriptors

  • 400

    A value is not valid, or the name is used by a built-in field

  • 403

    Your global role is not manager or administrator

POST /data/metadata-descriptors/all-projects
curl \
 --request POST '/api/data/metadata-descriptors/all-projects' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "entity_type": "Asset",
  "name": "string",
  "data_type": "string",
  "for_client": false,
  "choices": [
    "string"
  ],
  "departments": [
    "string"
  ]
}'
Request examples
{
  "entity_type": "Asset",
  "name": "string",
  "data_type": "string",
  "for_client": false,
  "choices": [
    "string"
  ],
  "departments": [
    "string"
  ]
}