action shutterstock_license_track {
  label: "License audio tracks"
  description: "This endpoint gets licenses for one or more tracks. The download links in the response are valid for 8 hours."
  provider: shutterstock
  method: POST
  path: "/v2/audio/licenses"
  encoding: json
  input: {
    type: "object"
    properties: {
      audio: {
        type: "array"
        description: "List of audio tracks to license"
        items: {
          type: "object"
          description: "An audio track in a licensing request"
          required: ["audio_id"]
          properties: {
            audio_id: {
              type: "string"
              description: "ID of the track being licensed"
            }
            license: {
              type: "string"
              description: "Type of license"
              enum: ["audio_platform", "premier_music_basic", "premier_music_extended", "premier_music_pro", "premier_music_comp", "asset_all_music"]
            }
            search_id: {
              type: "string"
              description: "ID of the search that led to this licensing event"
            }
          }
        }
      }
      license: {
        type: "string"
        enum: ["audio_platform", "premier_music_basic", "premier_music_extended", "premier_music_pro", "premier_music_comp", "asset_all_music"]
      }
      search_id: {
        type: "string"
      }
    }
    required: ["audio"]
    additionalProperties: false
  }
  output: {
    description: "List of audio license results"
    properties: {
      data: {
        type: "array"
        description: "License results"
        items: {
          type: "object"
          description: "The response to a licensing request for an audio track"
          required: ["audio_id"]
          properties: {
            allotment_charge: {
              type: "number"
              description: "Number of credits that this licensing event used"
            }
            audio_id: {
              type: "string"
              description: "ID of the track that was licensed"
            }
            download: {
              type: "object"
              description: "Audio License URL object"
              required: ["url"]
              properties: {
                shorts_loops_stems: {
                  type: "string"
                  description: "URL that can be used to download the .zip file containing shorts, loops, and stems"
                }
                url: {
                  type: "string"
                  description: "URL that can be used to download the unwatermarked, licensed asset"
                }
              }
            }
            error: {
              type: "string"
              description: "Error information if applicable"
            }
            license_id: {
              type: "string"
              description: "ID of the license event"
            }
          }
        }
      }
      errors: {
        type: "array"
        description: "Error list; appears only if there was an error"
        items: {
          type: "object"
          description: "Error object"
          required: ["message"]
          properties: {
            code: {
              type: "string"
              description: "The error code of this error"
            }
            data: {
              type: "string"
              description: "Debugging information about the error"
            }
            items: {
              type: "array"
              description: "A list of items that produced the error"
              items: {
                type: "object"
              }
            }
            message: {
              type: "string"
              description: "Specific details about this error"
            }
            path: {
              type: "string"
              description: "Internal code reference to the source of the error"
            }
          }
        }
      }
      message: {
        type: "string"
        description: "Server-generated message, if any"
      }
      page: {
        type: "integer"
        description: "Current page that is returned"
      }
      per_page: {
        type: "integer"
        description: "Number of results per page"
      }
      total_count: {
        type: "integer"
        description: "Total count of all results across all pages"
      }
    }
  }
}