Home

Shotgun provides a simple Python-based API for accessing Shotgun and integrating with other tools. This is the official API that is maintained by Shotgun Software ([email protected])

Minimum Requirements

• Shotgun server v2.4.12 or higher for API v3.0.8+. (Earlier Shotgun versions of 2.4 will work, but have buggy support for float field types)
• Shotgun server v1.8 or higher for API v3.0.7.
• Python v2.4 - v2.7. (We do have plans to eventually support Python 3)

Installation

To use Shotgun's Python API module, you need to place it in one of the directories specified by the environment variable PYTHONPATH. For more information on PYTHONPATH and using modules in Python, see http://docs.python.org/tutorial/modules.html

Getting Started

• API Overview
• Setting Up Shotgun for API Access
• API Usage Tips

Reference

• Reference: Methods
• Reference: Data Types
• Reference: Filter Syntax

Files

• Working With Local Files
• Working With Attachments

Tutorial Examples

• Create a Shot
• Find a Shot
• Update a Shot
• Delete a Shot
• Create a Shot with a Task Template
• Create a Version and link it to a Shot
• Upload a Thumbnail to a Version

Examples + Advanced Usage

• Task Dependencies
• Task Status Triggers
• Updating Task Dates: How Shotgun Thinks
• Event Types
• Subversion (SVN) Integration
• Handling ActionMenuItems
• Using an ActionMenuItem to Package Versions for a Client
• Smart Cut Fields
• Connection Entities