action shutterstock_license_images {
  label: "License images"
  description: "This endpoint gets licenses for one or more images. You must specify the image IDs in the body parameter and other details like the format, size, and subscription ID either in the query parameter or with each image ID in the body parameter. Values in the body parameter override values in the query parameters. The download links in the response are valid for 8 hours."
  provider: shutterstock
  method: POST
  path: "/v2/images/licenses"
  encoding: json
  input: {
    type: "object"
    properties: {
      format: {
        type: "string"
        enum: ["eps", "jpg"]
      }
      images: {
        type: "array"
        description: "Images to create licenses for"
        items: {
          type: "object"
        }
      }
      search_id: {
        type: "string"
      }
      size: {
        type: "string"
        enum: ["small", "medium", "huge", "vector", "custom"]
      }
      subscription_id: {
        type: "string"
      }
    }
    required: ["images"]
    additionalProperties: false
  }
  output: {
    description: "List of information about licensed images"
    properties: {
      data: {
        type: "array"
        description: "License results"
        items: {
          type: "object"
          description: "The response to a licensing request for an image"
          required: ["image_id"]
          properties: {
            allotment_charge: {
              type: "integer"
              description: "Number of credits that this licensing event used"
            }
            download: {
              type: "object"
              description: "URL object"
              required: ["url"]
              properties: {
                url: {
                  type: "string"
                  description: "URL that can be used to download the unwatermarked, licensed asset"
                }
              }
            }
            error: {
              type: "string"
              description: "Error message, appears only if there was an error"
            }
            image_id: {
              type: "string"
              description: "Image ID that was licensed"
            }
            license_id: {
              type: "string"
              description: "ID of the license event"
            }
            price: {
              type: "object"
              description: "Price"
              properties: {
                local_amount: {
                  type: "number"
                  description: "Floating-point amount of the calculated rev-share price in the currency local_currency"
                }
                local_currency: {
                  type: "string"
                  description: "Currency of the rev-share price that was calculated"
                }
              }
            }
          }
        }
      }
      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"
      }
    }
  }
}