Import Shotgun steps

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 /import/shotgun/steps

Import steps as task types from Shotgun. A step becomes a task type. Send a JSON list of Shotgun rows. A task type that exists in Kitsu, with the same Shotgun identifier or the same name and entity type, is updated. Else, it is created. The department is the first word of the code. The route creates the department if it does not exist. Without entity_type, the task type is for assets. A row that misses a field is skipped. You must be an administrator.

application/json

Body Required

  • id integer

    Shotgun ID of the step

  • code string

    Step code (used to extract department)

  • short_name string

    Step short name

  • color string

    Color in RGB format

  • entity_type string

    Entity type this step applies to

Responses

  • 200 application/json

    The created and updated rows

    Hide response attributes Show response attributes object
    • id string(uuid)

      Task type unique identifier

    • name string

      Task type name

    • short_name string

      Task type short name

    • color string

      Task type color in hex format

    • for_entity string

      Entity type

    • created_at string(date-time)

      Creation timestamp

    • updated_at string(date-time)

      Update timestamp

  • 400

    The body is not JSON

  • 403

    You are not an administrator

  • 500

    The body is not a list, or a row breaks a database constraint

POST /import/shotgun/steps
curl -X POST "http://api.example.com/import/shotgun/steps" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "id": 12345,
    "code": "Animation Modeling",
    "short_name": "mod",
    "color": "255,128,0",
    "entity_type": "Asset"
  }
]'
import requests

url = "http://api.example.com/import/shotgun/steps"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}
params = {}
payload = [
    {
        "id": 12345,
        "code": "Animation Modeling",
        "short_name": "mod",
        "color": "255,128,0",
        "entity_type": "Asset"
    }
]

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

response.raise_for_status()

if response.content:
    print(response.json())
Request example
[
  {
    "id": 12345,
    "code": "Animation Modeling",
    "short_name": "mod",
    "color": "255,128,0",
    "entity_type": "Asset"
  }
]
Response examples (200)
[
  {
    "id": "a24a6ea4-ce75-4665-a070-57453082c250",
    "name": "Animation Modeling",
    "short_name": "mod",
    "color": "#FF8000",
    "for_entity": "Asset",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T11:00:00Z"
  }
]