Update 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

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

PUT /data/projects/{instance_id}

Jwt authorization

Update the fields of a project. Send only the fields to change. You must be a manager in the team of the project, or an administrator. You cannot change id, created_at, updated_at and team. Use the team routes to change the team. The route checks production_style, resolution and the movie bitrates. A null production_style gives 2d3d. You can send preview_background_files, a list of preview background file identifiers. default_preview_background_file_id must be in the preview background files of the project. A tvshow project gets a first episode if it has none. Dates use the ISO 8601 format.

Path parameters

instance_id string(uuid) Required

Unique identifier of the project

application/json

Body Required

name string
production_style string
default_preview_background_file_id string(uuid)

Default preview background file of the project
preview_background_files array[string(uuid)]

Preview background files of the project

Responses

200 application/json

The updated 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, a date is not valid, a field breaks a database constraint, or a preview background file is not one of the preview background files of the project
403

You are not a manager in the team of the project
404

The project does not exist

PUT /data/projects/{instance_id}

curl -X PUT "http://api.example.com/data/projects/a24a6ea4-ce75-4665-a070-57453082c25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Updated Project Name",
  "production_style": "2d",
  "preview_background_file_id": "b24a6ea4-ce75-4665-a070-57453082c25"
}'

import requests

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

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

response.raise_for_status()

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

Request examples

{
  "name": "Updated Project Name",
  "production_style": "2d",
  "default_preview_background_file_id": "a24a6ea4-ce75-4665-a070-57453082c250",
  "preview_background_files": [
    "string"
  ]
}

Response examples (200)

{
  "id": "a24a6ea4-ce75-4665-a070-57453082c250",
  "name": "Updated Project Name",
  "production_type": "feature",
  "production_style": "2d",
  "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-15T11:00:00Z"
}