Welcome!

This site is here to teach you about all of the ways that developers can interact with the ShotGrid web app, the Toolkit platform for building artist pipelines, and the RV suite of digital review tools. The Guides section contains tutorials, guides, and other educational resources, while the Reference section holds detailed technical documentation for APIs and configuration files.

Who is this site for?

This documentation is intended for software engineers, Pipeline TDs, or anyone who will be setting up a pipeline and looking to develop tools around ShotGrid and RV.

For general help with using ShotGrid, please see the ShotGrid Help Portal.

How can I develop pipelines with ShotGrid?

ShotGrid provides a powerful set of tools for customizing your studio’s ShotGrid experience. Here are some of them.

Interested in interacting with ShotGrid through custom code?

  • The Python API provides CRUD methods to give you raw access to data going in and out of your ShotGrid database.
  • The REST API has functional parity with the Python API, but gives you full data access to ShotGrid in programming languages other than Python.
  • The Toolkit Core API provides an interface to the ShotGrid Pipeline Integrations, such as automating publishing, handling file locations, and building cross-software functional tools.

Want to automate processes around the ShotGrid web app?

ShotGrid offers a few technologies for adding triggers or custom menu items to your ShotGrid site:

  • Action Menu Items, or AMIs allow you to add items to the context menus on entities, from which ShotGrid users can run custom logic.
  • Webhooks allow you to create custom reactions to events that take place on your ShotGrid site. When a chosen event takes place, an HTTPS request is issued to an endpoint you define, with a payload of information about the event. You can then create custom code that uses this payload to react however you want.
  • The Event Daemon framework is another solution for creating reactions to events on your site. Choose the Event Daemon framework if you prefer to limit incoming internet connections to your studio.

Want to extend ShotGrid into your artist pipeline?

ShotGrid Toolkit is a platform for building plugin integrations within artists’ tools that bring the ShotGrid experience into production workflows and give you the foundation for a publish pipeline.

There are many ways to customize your Toolkit setup:

  • The Toolkit Pipeline Configuration is a set of YAML files that give you control of many options within Toolkit’s plugin apps.
  • Hooks allow you to inject custom Python logic at specific points in Toolkit’s workflows, without having to fork the main codebase.
  • The Toolkit Core API provides methods with which pipeline TDs can quickly build configurable tools that can run across common content creation software.
  • In addition, various app and framework APIs allow you to write code that handles specific Toolkit functionality, like publishing artist work, dealing with UI widgets, and various utilities.

Want to customize your studio’s media review experience?

RV was built from the ground up to be an extensible platform. It provides a flexible system for adding automation, with an interface built primarily through its API provided in Mu, Python, and Javascript. Some examples of custom behavior provided through plugins are:

  • Automating Color Pipelines and View Management
  • Providing artist-facing tools within RV that utilize existing studio libraries

Want to learn more about real-world ways that others are using ShotGrid?

Our Community Forums are a home for vibrant conversations among ShotGrid staff and users, administrators, and developers working with ShotGrid every day.


Edit this document