Authentication
Log user out by revoking his auth tokens.
Once logged out, current user cannot access the API anymore.
curl \
--request GET 'http://api.example.com/auth/logout' \
--header "Authorization: $API_KEY"
Tokens are considered as outdated every two weeks.
This route allows to make their lifetime long before they get outdated.
curl \
--request GET 'http://api.example.com/auth/refresh-token' \
--header "Authorization: $API_KEY"
curl \
--request POST 'http://api.example.com/auth/email-otp' \
--header "Authorization: $API_KEY"
Retrieve all asset instances instantiated inside given asset.
Path parameters
-
asset_id
Required
curl \
--request GET 'http://api.example.com/data/assets/{asset_id}/asset-asset-instances' \
--header "Authorization: $API_KEY"
Retrieve all shared assets used in project.
curl \
--request GET 'http://api.example.com/data/projects/{project_id}/assets/shared-used' \
--header "Authorization: $API_KEY"
Return all attachment files related to given project.
Path parameters
-
project_id
Required
curl \
--request GET 'http://api.example.com/data/projects/{project_id}/attachment-files' \
--header "Authorization: $API_KEY"
Retrieve all entries for given model.
Filters can be specified in the query string.
curl \
--request GET 'http://api.example.com/data/persons' \
--header "Authorization: $API_KEY"
Create a model with data given in the request body.
JSON format is expected. The model performs the validation automatically when instantiated.
curl \
--request POST 'http://api.example.com/data/entity-types' \
--header "Authorization: $API_KEY"
Retrieve a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request GET 'http://api.example.com/data/task-types/{instance_id}' \
--header "Authorization: $API_KEY"
Create a model with data given in the request body.
JSON format is expected. The model performs the validation automatically when instantiated.
curl \
--request POST 'http://api.example.com/data/task-status' \
--header "Authorization: $API_KEY"
Retrieve a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request GET 'http://api.example.com/data/tasks/{instance_id}' \
--header "Authorization: $API_KEY"
Update a model with data given in the request body.
JSON format is expected. Model performs the validation automatically when fields are modified.
Path parameters
-
instance_id
Required
curl \
--request PUT 'http://api.example.com/data/file-status/{instance_id}' \
--header "Authorization: $API_KEY"
Retrieve a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request GET 'http://api.example.com/data/time-spents/{instance_id}' \
--header "Authorization: $API_KEY"
Delete a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request DELETE 'http://api.example.com/data/day-offs/{instance_id}' \
--header "Authorization: $API_KEY"
Create a model with data given in the request body.
JSON format is expected. The model performs the validation automatically when instantiated.
curl \
--request POST 'http://api.example.com/data/asset-instances/' \
--header "Authorization: $API_KEY"
Retrieve a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request GET 'http://api.example.com/data/events/{instance_id}' \
--header "Authorization: $API_KEY"
Delete a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request DELETE 'http://api.example.com/data/subscriptions/{instance_id}' \
--header "Authorization: $API_KEY"
Retrieve a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request GET 'http://api.example.com/data/chat-messages/{instance_id}' \
--header "Authorization: $API_KEY"
curl \
--request GET 'http://api.example.com/data/salary-scales' \
--header "Authorization: $API_KEY"
Retrieve a model corresponding at given ID and return it as a JSON object.
Path parameters
-
instance_id
Required
curl \
--request GET 'http://api.example.com/data/salary-scales/{instance_id}' \
--header "Authorization: $API_KEY"
Update a model with data given in the request body.
JSON format is expected. Model performs the validation automatically when fields are modified.
Path parameters
-
instance_id
Required
curl \
--request PUT 'http://api.example.com/data/plugins/{instance_id}' \
--header "Authorization: $API_KEY"
curl \
--request GET 'http://api.example.com/export/csv/time-spents.csv' \
--header "Authorization: $API_KEY"
Get information about a file that could be a working file as much as an
output file.
Path parameters
-
file_id
Required
curl \
--request GET 'http://api.example.com/data/files/{file_id}' \
--header "Authorization: $API_KEY"
Get all output files for given entity.
Path parameters
-
entity_id
Required
Query parameters
-
output_type_id
Required -
task_type_id
Required -
file_status_id
Required -
representation
Required
curl \
--request GET 'http://api.example.com/data/entities/{entity_id}/output-files' \
--header "Authorization: $API_KEY"
Update comment on given working file.
Path parameters
-
working_file_id
Required
curl \
--request PUT 'http://api.example.com/actions/working-files/{working_file_id}/comment' \
--header "Authorization: $API_KEY"
curl \
--request POST 'http://api.example.com/import/shotgun/persons' \
--header "Authorization: $API_KEY"
curl \
--request POST 'http://api.example.com/import/shotgun/status' \
--header "Authorization: $API_KEY"
curl \
--request POST 'http://api.example.com/import/shotgun/tasks' \
--header "Authorization: $API_KEY"
curl \
--request GET 'http://api.example.com/status/test-event' \
--header "Authorization: $API_KEY"
curl \
--request GET 'http://api.example.com/config' \
--header "Authorization: $API_KEY"
Return a table giving time spent by user and by day for given year and month.
curl \
--request GET 'http://api.example.com/data/persons/time-spents/day-table/{year}/{month}' \
--header "Authorization: $API_KEY"
Return all day off recorded for given week and person.
curl \
--request GET 'http://api.example.com/data/persons/{person_id}/day-offs/week/{year}/{week}' \
--header "Authorization: $API_KEY"
Remove given build job related to given playlist.
Path parameters
-
playlist_id
Required -
build_job_id
Required
curl \
--request DELETE 'http://api.example.com/data/playlists/{playlist_id}/jobs/{build_job_id}' \
--header "Authorization: $API_KEY"
Path parameters
-
playlist_id
Required
curl \
--request GET 'http://api.example.com/data/playlists/{playlist_id}/download/zip' \
--header "Authorization: $API_KEY"
Retrieve all playlists related to given project.
It's mainly used for synchronisation purpose.
Path parameters
-
project_id
Required
curl \
--request POST 'http://api.example.com/data/projects/{project_id}/playlists/temp' \
--header "Authorization: $API_KEY"
Retrieve all preview files from open productions with states equals to processing or broken.
curl \
--request GET 'http://api.example.com/data/playlists/preview-files/running' \
--header "Authorization: $API_KEY"
Path parameters
-
instance_id
Required
curl \
--request GET 'http://api.example.com/movies/low/preview-files/{instance_id}.mp4' \
--header "Authorization: $API_KEY"
Download a generic file preview.
Path parameters
-
instance_id
Required -
extension
Required
curl \
--request GET 'http://api.example.com/pictures/originals/preview-files/{instance_id}.{extension}' \
--header "Authorization: $API_KEY"
Create a thumbnail for given object instance.
Path parameters
-
instance_id
Required
curl \
--request POST 'http://api.example.com/pictures/thumbnails/preview-background-files/{instance_id}.png' \
--header "Authorization: $API_KEY"
Allow to change orders of previews for a single revision.
This preview will be used to illustrate the entity.
Path parameters
-
preview_file_id
Required
curl \
--request PUT 'http://api.example.com/actions/preview-files/{preview_file_id}/update-position' \
--header "Authorization: $API_KEY"
Retrieve schedule items for given production
Path parameters
-
project_id
Required
curl \
--request GET 'http://api.example.com/data/projects/{project_id}/schedule-items' \
--header "Authorization: $API_KEY"
Delete a budget for given production
Path parameters
-
project_id
Required -
budget_id
Required
curl \
--request DELETE 'http://api.example.com/data/projects/{project_id}/budgets/{budget_id}' \
--header "Authorization: $API_KEY"
Update a budget entry for given production and budget
Path parameters
-
project_id
Required -
budget_id
Required -
entry_id
Required
curl \
--request PUT 'http://api.example.com/data/projects/{project_id}/budgets/{budget_id}/entries/{entry_id}' \
--header "Authorization: $API_KEY"
Retrieve all task types related to a given shot.
Path parameters
-
shot_id
Required
curl \
--request GET 'http://api.example.com/data/shots/{shot_id}/task-types' \
--header "Authorization: $API_KEY"
Path parameters
-
shot_id
Required
curl \
--request GET 'http://api.example.com/data/shots/{shot_id}/versions' \
--header "Authorization: $API_KEY"
curl \
--request GET 'http://api.example.com/data/scenes/all' \
--header "Authorization: $API_KEY"
Delete given shot from given scene.
curl \
--request DELETE 'http://api.example.com/data/scenes/{scene_id}/shots/{shot_id}' \
--header "Authorization: $API_KEY"
Retrieve all episodes related to a given project.
Path parameters
-
project_id
Required
curl \
--request GET 'http://api.example.com/data/projects/{project_id}/episodes' \
--header "Authorization: $API_KEY"
Delete a comment corresponding at given ID.
Path parameters
-
task_id
Required -
comment_id
Required
curl \
--request DELETE 'http://api.example.com/data/tasks/{task_id}/comments/{comment_id}' \
--header "Authorization: $API_KEY"
curl \
--request PUT 'http://api.example.com/actions/tasks/clear-assignation' \
--header "Authorization: $API_KEY"
Get time spent on a given task and date.
curl \
--request GET 'http://api.example.com/actions/tasks/{task_id}/time-spents/{date}' \
--header "Authorization: $API_KEY"
Delete preview from given comment.
Path parameters
-
task_id
Required -
comment_id
Required -
preview_file_id
Required
curl \
--request DELETE 'http://api.example.com/actions/tasks/{task_id}/comments/{comment_id}/preview-files/{preview_file_id}' \
--header "Authorization: $API_KEY"
Return tasks related to given scene for current user.
Path parameters
-
scene_id
Required
curl \
--request GET 'http://api.example.com/data/user/scenes/{scene_id}/tasks' \
--header "Authorization: $API_KEY"
Return episodes related to given project if the current user has access
to it.
Path parameters
-
project_id
Required
curl \
--request GET 'http://api.example.com/data/user/projects/{project_id}/episodes' \
--header "Authorization: $API_KEY"
Update given filter if it's owned by current user.
Path parameters
-
filter_id
Required
curl \
--request PUT 'http://api.example.com/data/user/filters/{filter_id}' \
--header "Authorization: $API_KEY"
Return true if current user has subscribed to given task.
Path parameters
-
task_id
Required
curl \
--request GET 'http://api.example.com/data/user/tasks/{task_id}/subscribed' \
--header "Authorization: $API_KEY"