Get a picture of a preview

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 /pictures/thumbnails/preview-files/{instance_id}.png

Jwt authorization

Get a picture of a preview file. It can be the thumbnail, the square thumbnail, the original picture or the preview picture. For the thumbnail, the square thumbnail and the original picture, anybody who is logged in can get the main preview of a shared entity, except vendors. For the preview picture, and for the other previews, you must have access to the task. A vendor must have a task on the entity.

Path parameters

instance_id string(uuid) Required

Unique identifier of the preview file

Responses

200 image/png

The PNG picture
202 application/json

The preview is still processing. The body has the status and the Retry-After header gives the delay. Only for a client that accepts application/json. Other clients get a 404.
Hide response attributes Show response attributes object
- status string
- preview_file_id string(uuid)
403

You do not have access to the task of this preview
404

The preview file or its file does not exist

GET /pictures/thumbnails/preview-files/{instance_id}.png

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

import requests

url = "http://api.example.com/pictures/thumbnails/preview-files/a24a6ea4-ce75-4665-a070-57453082c25.png"
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 (202)

{
  "status": "processing",
  "preview_file_id": "a24a6ea4-ce75-4665-a070-57453082c250"
}