Create a project

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
POST /data/projects
Jwt authorization

Create a project. Send the fields of the new row in JSON. You must be an administrator. A null production_style gives 2d3d. The route checks production_style, resolution and the movie bitrates. With project_template_id, the route applies the template, its asset type workflows included. The fields you send override the template values. Without project_status_id, the project gets the open status. default_preview_background_file_id must be in preview_background_files. A tvshow project gets a first episode E01. The project gets a copy of the metadata descriptors set for all projects.

application/json

Body Required

  • name string Required
  • production_type string
  • production_style string

    Default value is 2d3d.

  • project_status_id string(uuid)

Responses

  • 201 application/json

    The new project

    Hide response attributes Show response attributes object
    • id string(uuid)
    • name string
    • production_type string
    • production_style string
    • project_status_id string(uuid)
    • first_episode_id string(uuid)
    • created_at string(date-time)
    • updated_at string(date-time)
  • 400

    The body is not valid, or a field breaks a database constraint

  • 403

    You are not an administrator

POST /data/projects 
curl -X POST "http://api.example.com/data/projects" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Project Name",
  "production_type": "feature",
  "production_style": "2d3d",
  "project_status_id": "a24a6ea4-ce75-4665-a070-57453082c25"
}'
import requests

url = "http://api.example.com/data/projects"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}
params = {}
payload = {
    "name": "Project Name",
    "production_type": "feature",
    "production_style": "2d3d",
    "project_status_id": "a24a6ea4-ce75-4665-a070-57453082c25"
}

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

response.raise_for_status()

if response.content:
    print(response.json())
Request examples 
{
  "name": "Project Name",
  "production_type": "feature",
  "production_style": "2d3d",
  "project_status_id": "a24a6ea4-ce75-4665-a070-57453082c250"
}
Response examples (201) 
{
  "id": "a24a6ea4-ce75-4665-a070-57453082c250",
  "name": "Project Name",
  "production_type": "feature",
  "production_style": "2d3d",
  "project_status_id": "b24a6ea4-ce75-4665-a070-57453082c250",
  "first_episode_id": "c24a6ea4-ce75-4665-a070-57453082c250",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}