Get my filters

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"
  }
}

GET /data/user/filters

Jwt authorization

Get your filters and the shared filters of your open projects. Your own filters are listed whatever their department. A filter of someone else linked to a department is listed only if you are in this department or if you are a manager or an administrator. The response is an object. The first key is the list type. The second key is the project identifier, or all for the filters without project.

Responses

200 application/json

The filters, by list type and by project
Hide response attribute Show response attribute object
- * object Additional properties
  
  Hide * attribute Show * attribute object
  
  * array[object] Additional properties
  
  Hide * attributes Show * attributes object
  
  id string(uuid)
  
  Filter unique identifier
  
  name string
  
  Filter name
  
  query string
  
  Filter query JSON
  
  list_type string
  
  List type
  
  entity_type string
  
  Entity type
  
  project_id string(uuid)
  
  Project identifier
  
  is_shared boolean
  
  Whether filter is shared
  
  created_at string(date-time)
  
  Creation timestamp
  
  updated_at string(date-time)
  
  Last update timestamp
403

You use a bot token

GET /data/user/filters

curl -X GET "http://api.example.com/data/user/filters" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

import requests

url = "http://api.example.com/data/user/filters"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {}
payload = None

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

response.raise_for_status()

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

Response examples (200)

{
  "additionalProperty1": {
    "additionalProperty1": [
      {
        "id": "a24a6ea4-ce75-4665-a070-57453082c250",
        "name": "My Filter",
        "query": "{\"project_id\": \"uuid\"}",
        "list_type": "todo",
        "entity_type": "Asset",
        "project_id": "b35b7fb5-df86-5776-b181-68564193d360",
        "is_shared": false,
        "created_at": "2023-01-01T12:00:00Z",
        "updated_at": "2023-01-01T12:30:00Z"
      }
    ],
    "additionalProperty2": [
      {
        "id": "a24a6ea4-ce75-4665-a070-57453082c250",
        "name": "My Filter",
        "query": "{\"project_id\": \"uuid\"}",
        "list_type": "todo",
        "entity_type": "Asset",
        "project_id": "b35b7fb5-df86-5776-b181-68564193d360",
        "is_shared": false,
        "created_at": "2023-01-01T12:00:00Z",
        "updated_at": "2023-01-01T12:30:00Z"
      }
    ]
  },
  "additionalProperty2": {
    "additionalProperty1": [
      {
        "id": "a24a6ea4-ce75-4665-a070-57453082c250",
        "name": "My Filter",
        "query": "{\"project_id\": \"uuid\"}",
        "list_type": "todo",
        "entity_type": "Asset",
        "project_id": "b35b7fb5-df86-5776-b181-68564193d360",
        "is_shared": false,
        "created_at": "2023-01-01T12:00:00Z",
        "updated_at": "2023-01-01T12:30:00Z"
      }
    ],
    "additionalProperty2": [
      {
        "id": "a24a6ea4-ce75-4665-a070-57453082c250",
        "name": "My Filter",
        "query": "{\"project_id\": \"uuid\"}",
        "list_type": "todo",
        "entity_type": "Asset",
        "project_id": "b35b7fb5-df86-5776-b181-68564193d360",
        "is_shared": false,
        "created_at": "2023-01-01T12:00:00Z",
        "updated_at": "2023-01-01T12:30:00Z"
      }
    ]
  }
}