action shutterstock_license_editorial_video {
  label: "License editorial video content"
  description: "This endpoint gets licenses for one or more editorial videos. You must specify the country and one or more editorial videos to license. The download links in the response are valid for 8 hours."
  provider: shutterstock
  method: POST
  path: "/v2/editorial/videos/licenses"
  encoding: json
  input: {
    type: "object"
    description: "License editorial video content request"
    required: ["country", "editorial"]
    properties: {
      country: {
        description: "A valid ISO 3166-1 Alpha-2 or ISO 3166-1 Alpha-3 code."
        type: "object"
      }
      editorial: {
        type: "array"
        description: "Editorial content to license"
        items: {
          type: "object"
          description: "Individual editorial video content to license"
          required: ["editorial_id", "license"]
          properties: {
            editorial_id: {
              type: "string"
              description: "Editorial ID"
            }
            license: {
              type: "string"
              description: "License agreement to use for licensing"
              enum: ["premier_editorial_video_digital_only", "premier_editorial_video_all_media", "premier_editorial_video_all_media_single_territory", "premier_editorial_video_comp"]
            }
            metadata: {
              type: "object"
              description: "Additional information for license requests for enterprise accounts and API subscriptions, 4 fields maximum; which fields are required is set by the account holder"
              properties: {}
            }
            size: {
              type: "string"
              description: "Asset size to download"
              enum: ["original"]
            }
          }
        }
      }
    }
  }
  output: {
    description: "List of editorial license results"
    properties: {
      data: {
        type: "array"
        description: "License results"
        items: {
          type: "object"
          description: "The response to a licensing request for editorial content"
          required: ["editorial_id"]
          properties: {
            allotment_charge: {
              type: "integer"
              description: "For pre-paid plans, how many credits were used for the item license"
            }
            download: {
              type: "object"
              description: "URL object"
              required: ["url"]
              properties: {
                url: {
                  type: "string"
                  description: "URL that can be used to download the unwatermarked, licensed asset"
                }
              }
            }
            editorial_id: {
              type: "string"
              description: "Editorial ID"
            }
            error: {
              type: "string"
            }
          }
        }
      }
      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: "Optional error message"
      }
      page: {
        type: "integer"
        description: "Current page of the response"
      }
      per_page: {
        type: "integer"
        description: "Number of results per page"
      }
      total_count: {
        type: "integer"
        description: "Total count of all results"
      }
    }
  }
}