Approve Single Deliverable

putapi.bunnystudio.com/deliverables/{id}

This endpoint will approve a specific deliverable by its UUID.

Requirements

Authentication

x-access-token

Scope

deliverables

Path parameters

id

string
Bunny Studio UUID of the deliverable you want to approve

Request body

status

string
Should send the string "approved"

Request example

Console

 curl --request PUT \ 
      --url https://api.bunnystudio.com/deliverables/DELIVERABLE_ID \
      --header "Content-Type: application/json" \
      --header "x-access-token: YOUR_TOKEN" \
      --data '{
        "status": "approved",
        }'

JavaScript

  const url = 'https://api.bunnystudio.com/deliverables/DELIVERABLE_ID';
  const options = {
    method: 'PUT',
    headers: {
      'content-type': 'application/json',
      'x-access-token': 'YOUR_TOKEN',
    }
    body: JSON.stringify(
      {
        "status": "approved",
        }
    )
  }; 
  fetch(url, options)
    .then(response => response.json())
    .then(response => console.log(response))
    .catch(err => console.error(err));

Python

  import requests
  import json
  api_url = "https://api.bunnystudio.com/deliverables/DELIVERABLE_ID"
  headers = {
    "Content-Type": "application/json; charset=utf-8",
    'x-access-token': 'YOUR_TOKEN',
  }
  body = {
   "status": "approved",
   }
  response = requests.put(api_url, headers=headers, json=body)
  print(response.text)

PHP - CURL

<?php
  $curl = curl_init();
  curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.bunnystudio.com/deliverables/DELIVERABLE_ID',
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_HTTPHEADER => array(
      'content-type': 'application/json',
      'x-access-token': 'YOUR_TOKEN',
    ),
    CURLOPT_POSTFIELDS => '{
      "status": "approved",
      }'
  ));
  $response = curl_exec($curl);
  curl_close($curl);
  echo $response;

Response format

id

string
A UUID (Universal Unique Identifier) that identifies the deliverable on Bunny Studio's database. You should use this ID for all API actions related to a specific deliverable.

serviceSubCategory

string
The category of this deliverable

name

string
The name of the deliverable. If it consists of multiple parts, the string will usually represent the part number (e.g. "Part 2").

status

string
The status of the deliverable

Response example

{
  "id": "671e74ab-ca44-4d87-9346-ae8318c44774",
  "serviceSubCategory": "voice_over",
  "name": "part1",
  "status": "approved",
}

Error responses

500 Error approving project

  {
    status: 500,
    type: 'ERROR_APPROVING_DELIVERABLE',
    message: 'There was an error approving the deliverable with id \"DELIVERABLE_ID\", please talk with our support team',
  }

400 Deliverable not exist

  {
    status: 404,
    type: 'DELIVERABLE_NO_EXIST',
    message: 'Deliverable with id \"DELIVERABLE_ID\" not found',
  }

404 Deliverable already approved

  {
    status: 404,
    type: 'DELIVERABLE_ALREADY_APPROVED',
    message: 'Deliverable with id \"DELIVERABLE_ID\" is already approved',
  }

404 Deliverable not pending review

  {
    status: 404,
    type: 'DELIVERABLE_NOT_PENDING_REVIEW',
    message: 'Deliverable with id \"DELIVERABLE_ID\" is not pending a review',
  }

403 Forbidden

  {
    status: 403,
    type: 'FORBIDDEN',
    message: 'You do not have permission to do this action',
  }

422 Id required

  {
    status: 422,
    type: 'ID_REQUIRED',
    message: 'The field "\id\" is required',
  }