action shutterstock_get_contributor_collections_list {
  label: "List contributors' collections"
  description: "This endpoint lists collections based on contributor ID."
  provider: shutterstock
  method: GET
  path: "/v2/contributors/{contributor_id}/collections"
  encoding: json
  input: {
    type: "object"
    properties: {
      contributor_id: {
        type: "string"
      }
      sort: {
        type: "string"
        enum: ["newest", "last_updated", "item_count"]
      }
    }
    required: ["contributor_id"]
    additionalProperties: false
  }
  output: {
    description: "List of collections"
    properties: {
      data: {
        type: "array"
        description: "Collections"
        items: {
          type: "object"
          description: "Metadata about a collection of assets"
          required: ["id", "name", "total_item_count"]
          properties: {
            cover_item: {
              type: "object"
              description: "Metadata about an item that is part of a collection"
              required: ["id"]
              properties: {
                added_time: {
                  type: "string"
                  format: "date-time"
                  description: "The date the item was added to the collection"
                }
                id: {
                  type: "string"
                  description: "ID of the item"
                }
                media_type: {
                  type: "string"
                  description: "The media type of the item, such as image, video, or audio"
                }
              }
            }
            created_time: {
              type: "string"
              format: "date-time"
              description: "When the collection was created"
            }
            id: {
              type: "string"
              description: "The collection ID"
            }
            items_updated_time: {
              type: "string"
              format: "date-time"
              description: "The last time this collection's items were updated"
            }
            name: {
              type: "string"
              description: "The name of the collection"
            }
            share_code: {
              type: "string"
              description: "A code that can be used to share the collection (optional)"
            }
            share_url: {
              type: "string"
              description: "The browser URL that can be used to share the collection (optional)"
            }
            total_item_count: {
              type: "integer"
              description: "The number of items in the collection"
            }
            updated_time: {
              type: "string"
              format: "date-time"
              description: "The last time the collection was update (other than changes to the items in it)"
            }
          }
        }
      }
      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: "The current page of results"
      }
      per_page: {
        type: "integer"
        description: "The number of results per page"
      }
      total_count: {
        type: "integer"
        description: "The total number of results across all pages"
      }
    }
  }
}