Update a filter group

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

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

PUT /data/user/filter-groups/{filter_group_id}

Jwt authorization

Update a filter group. The group must be yours. An administrator can update the groups of all the users. The group stays in its project. A project_id in the body is ignored. A null department_id removes the department. If the department changes, the filters of the group on the former one follow it. A new name must be free among the groups of the owner with the same list_type, entity_type, and project_id. To set is_shared to true, the group must have a project, and you must be a manager of this project or an administrator. Otherwise is_shared is set to false. A change of department on a group that stays shared needs the same role. Otherwise it is ignored. If you change is_shared, the filters of the group take the same value.

Path parameters

filter_group_id string(uuid) Required

Unique identifier of the filter group

application/json

Body Required

name string

Filter group name

Minimum length is 1, maximum length is 200.
color string

Filter group color

Maximum length is 8.
is_shared boolean

Whether to share this filter group
department_id string(uuid) | null

Department identifier

Responses

200 application/json

The updated filter group
Hide response attributes Show response attributes object
- id string(uuid)
  
  Filter group unique identifier
- name string
  
  Filter group name
- color string
  
  Filter group color
- list_type string
  
  List type
- entity_type string
  
  Entity type
- project_id string(uuid)
  
  Project identifier
- is_shared boolean
  
  Whether filter group is shared
- created_at string(date-time)
  
  Creation timestamp
- updated_at string(date-time)
  
  Last update timestamp
400

The body is not valid, or the name is already used in this list
403

You use a bot token
404

You have no filter group with this identifier, or the department does not exist

PUT /data/user/filter-groups/{filter_group_id}

curl -X PUT "http://api.example.com/data/user/filter-groups/a24a6ea4-ce75-4665-a070-57453082c25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Updated Filter Group",
  "color": "#00FF00",
  "is_shared": true,
  "department_id": "c46c8gc6-eg97-6887-c292-79675204e47"
}'

import requests

url = "http://api.example.com/data/user/filter-groups/a24a6ea4-ce75-4665-a070-57453082c25"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}
params = {}
payload = {
    "name": "Updated Filter Group",
    "color": "#00FF00",
    "is_shared": true,
    "department_id": "c46c8gc6-eg97-6887-c292-79675204e47"
}

response = requests.put(
    url,
    headers=headers,
    params=params,
    json=payload
)

response.raise_for_status()

if response.content:
    print(response.json())

Request examples

{
  "name": "Updated Filter Group",
  "color": "#00FF00",
  "is_shared": true,
  "department_id": "c46c80c6-e097-6887-c292-79675204e470"
}

Response examples (200)

{
  "id": "d57d91d7-f108-7998-d403-80786315f580",
  "name": "Updated Filter Group",
  "color": "#00FF00",
  "list_type": "todo",
  "entity_type": "Asset",
  "project_id": "e68e02e8-0219-8009-e514-918974260690",
  "is_shared": true,
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:30:00Z"
}