action figshare_institution_articles {
  label: "Public Licenses"
  description: "Returns a list of articles belonging to the institution"
  provider: figshare
  method: GET
  path: "/institutions/{institution_string_id}/articles/filter-by"
  encoding: json
  input: {
    type: "object"
    properties: {
      filename: {
        type: "string"
      }
      institution_string_id: {
        type: "string"
      }
      resource_id: {
        type: "string"
      }
    }
    required: ["filename", "institution_string_id", "resource_id"]
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      required: ["id", "title", "doi", "handle", "group_id", "url", "url_public_html", "url_public_api", "url_private_html", "url_private_api", "published_date", "timeline", "thumb", "defined_type", "defined_type_name"]
      properties: {
        defined_type: {
          type: "integer"
          format: "int64"
          description: "Type of article identifier"
        }
        defined_type_name: {
          type: "string"
          description: "Name of the article type identifier"
        }
        doi: {
          type: "string"
          description: "DOI"
        }
        group_id: {
          type: "number"
          description: "Group ID"
        }
        handle: {
          type: "string"
          description: "Handle"
        }
        id: {
          type: "integer"
          format: "int64"
          description: "Unique identifier for article"
        }
        published_date: {
          type: "string"
          description: "Posted date"
        }
        thumb: {
          type: "string"
          format: "url"
          description: "Thumbnail image"
        }
        timeline: {
          type: "object"
          required: ["posted", "submission", "revision", "firstOnline", "publisherPublication", "publisherAcceptance"]
          properties: {
            posted: {
              type: "string"
              description: "Posted date"
            }
            revision: {
              type: "string"
              description: "Revision date from curation (if curated)"
            }
            submission: {
              type: "string"
              description: "Submission date in curation (if curated)"
            }
          }
        }
        title: {
          type: "string"
          description: "Title of article"
        }
        url: {
          type: "string"
          format: "url"
          description: "Api endpoint for article"
        }
        url_private_api: {
          type: "string"
          format: "url"
          description: "Private Api endpoint for article"
        }
        url_private_html: {
          type: "string"
          format: "url"
          description: "Private site endpoint for article"
        }
        url_public_api: {
          type: "string"
          format: "url"
          description: "Public Api endpoint for article"
        }
        url_public_html: {
          type: "string"
          format: "url"
          description: "Public site endpoint for article"
        }
      }
    }
  }
}