action shutterstock_get_featured_image_collection_list {
  label: "List featured image collections"
  description: "This endpoint lists featured collections of specific types and a name and cover image for each collection."
  provider: shutterstock
  method: GET
  path: "/v2/images/collections/featured"
  encoding: json
  input: {
    type: "object"
    properties: {
      asset_hint: {
        type: "string"
        enum: ["1x", "2x"]
      }
      embed: {
        type: "string"
        enum: ["share_url"]
      }
      type: {
        type: "array"
        items: {
          type: "string"
          enum: ["photo", "editorial", "vector"]
        }
      }
    }
    additionalProperties: false
  }
  output: {
    description: "List of featured collections"
    properties: {
      data: {
        type: "array"
        description: "Featured collections"
        items: {
          type: "object"
          description: "Metadata about a featured collection"
          required: ["id", "name", "total_item_count"]
          properties: {
            cover_item: {
              type: "object"
              description: "Featured collection cover item metadata"
              required: ["url"]
              properties: {
                url: {
                  type: "string"
                  description: "URL of the collection cover item"
                }
              }
            }
            created_time: {
              type: "string"
              format: "date-time"
              description: "Date that the collection was created"
            }
            hero_item: {
              type: "object"
              additionalProperties: true
            }
            id: {
              type: "string"
              description: "Collection ID"
            }
            items_updated_time: {
              type: "string"
              format: "date-time"
              description: "Date that an item in the collection was last added or removed"
            }
            name: {
              type: "string"
              description: "Name of the collection"
            }
            share_url: {
              type: "string"
              description: "Unique share url for the collection"
            }
            total_item_count: {
              type: "integer"
              description: "Total number of items in the collection"
            }
            updated_time: {
              type: "string"
              format: "date-time"
              description: "Date that the collection was last modified"
            }
          }
        }
      }
      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"
      }
    }
  }
}