Get the preview files of an entity

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/entities/{entity_id}/preview-files

Jwt authorization

Get the preview files of the tasks of an entity.

Path parameters

entity_id string(uuid) Required

Unique identifier of the entity

Responses

200 application/json

The list of preview files
Hide response attributes Show response attributes object
- id string(uuid)
  
  Preview file unique identifier
- name string
  
  Preview file name
- path string
  
  File path
- revision integer
  
  File revision number
- created_at string(date-time)
  
  Creation timestamp
- entity_id string(uuid)
  
  Entity identifier
- task_id string(uuid)
  
  Task identifier
403

You do not have access to this entity
404

The entity does not exist

GET /data/entities/{entity_id}/preview-files

curl -X GET "http://api.example.com/data/entities/a24a6ea4-ce75-4665-a070-57453082c25/preview-files" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

import requests

url = "http://api.example.com/data/entities/a24a6ea4-ce75-4665-a070-57453082c25/preview-files"
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)

[
  {
    "id": "a24a6ea4-ce75-4665-a070-57453082c250",
    "name": "preview_001.jpg",
    "path": "/previews/entity/preview_001.jpg",
    "revision": 1,
    "created_at": "2023-01-01T12:00:00Z",
    "entity_id": "b35b7fb5-df86-5776-b181-68564193d360",
    "task_id": "c46c80c6-e097-6887-c292-79675204e470"
  }
]