Update 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
PUT /data/metadata-descriptors/all-projects/{field_name}
Jwt authorization

Update the metadata descriptors with this field name in your projects, in one request. 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.

Path parameters

  • field_name string Required

    Field name of the descriptor, the key in the data field

application/json

Body Required

  • entity_type string Required

    Entity type of the descriptor: Asset, Shot, Edit, Episode, Sequence or Project

  • name string

    New name of the column

  • for_client boolean

    Show the column to the clients

    Default value is false.

  • data_type string

    Type of the values, for example string, number, list or boolean

    Default value is string.

  • choices array[string]

    Values of a list column

  • departments array[string(uuid)]

    Departments that see the column

Responses

  • 200

    The updated descriptors

  • 400

    A value is not valid, or the name is used by another column of the same type, by a built-in field, or is too long

  • 403

    Your global role is not manager or administrator

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