Import Shotgun tasks

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"
  }
}

POST /import/shotgun/tasks

Jwt authorization

Import tasks from Shotgun. The route imports only the tasks that have a step and a project. Send a JSON list of Shotgun rows. A task that exists in Kitsu, with the same Shotgun identifier or the same name, project, step and entity, is updated. Else, it is created. A row with an assignee that is not in Kitsu is skipped. A row that misses a field is skipped. You must be an administrator.

application/json

Body Required

id integer

Shotgun ID of the task
cached_display_name string

Task display name
start_date string(date)

Start date
due_date string(date)

Due date
sg_sort_order integer

Sort order
duration integer

Duration in days
step object

Step (task type) information
Hide step attribute Show step attribute object
- id integer
project object

Project information
Hide project attribute Show project attribute object
- id integer
entity object

Entity information
Hide entity attributes Show entity attributes object
- id integer
- type string
sg_status_list string

Status short name
created_by object

Creator information
Hide created_by attribute Show created_by attribute object
- id integer
task_assignees array[object]

Task assignees
Hide task_assignees attribute Show task_assignees attribute object
- id integer

Responses

200 application/json

The created and updated rows
Hide response attributes Show response attributes object
- id string(uuid)
  
  Task unique identifier
- name string
  
  Task name
- start_date string(date)
  
  Start date
- due_date string(date)
  
  Due date
- 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/tasks

curl -X POST "http://api.example.com/import/shotgun/tasks" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "id": 12345,
    "cached_display_name": "Modeling for Asset",
    "start_date": "2024-01-15",
    "due_date": "2024-02-15",
    "sg_sort_order": 1,
    "duration": 30,
    "step": {
      "id": 11111
    },
    "project": {
      "id": 22222
    },
    "entity": {
      "id": 33333,
      "type": "Asset"
    },
    "sg_status_list": "IP",
    "created_by": {
      "id": 44444
    },
    "task_assignees": [
      {
        "id": 55555
      }
    ]
  }
]'

import requests

url = "http://api.example.com/import/shotgun/tasks"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}
params = {}
payload = [
    {
        "id": 12345,
        "cached_display_name": "Modeling for Asset",
        "start_date": "2024-01-15",
        "due_date": "2024-02-15",
        "sg_sort_order": 1,
        "duration": 30,
        "step": {
            "id": 11111
        },
        "project": {
            "id": 22222
        },
        "entity": {
            "id": 33333,
            "type": "Asset"
        },
        "sg_status_list": "IP",
        "created_by": {
            "id": 44444
        },
        "task_assignees": [
            {
                "id": 55555
            }
        ]
    }
]

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

response.raise_for_status()

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

Request example

[
  {
    "id": 12345,
    "cached_display_name": "Modeling for Asset",
    "start_date": "2024-01-15",
    "due_date": "2024-02-15",
    "sg_sort_order": 1,
    "duration": 30,
    "step": {
      "id": 11111
    },
    "project": {
      "id": 22222
    },
    "entity": {
      "id": 33333,
      "type": "Asset"
    },
    "sg_status_list": "IP",
    "created_by": {
      "id": 44444
    },
    "task_assignees": [
      {
        "id": 55555
      }
    ]
  }
]

Response examples (200)

[
  {
    "id": "a24a6ea4-ce75-4665-a070-57453082c250",
    "name": "Modeling for Asset",
    "start_date": "2024-01-15",
    "due_date": "2024-02-15",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T11:00:00Z"
  }
]