action figshare_private_article_create {
  label: "Create new Article"
  description: "Create a new Article by sending article information"
  provider: figshare
  method: POST
  path: "/account/articles"
  encoding: json
  input: {
    type: "object"
    required: ["title"]
    properties: {
      authors: {
        type: "array"
        description: "List of authors to be associated with the article. The list can contain the following fields: id, name, first_name, last_name, email, orcid_id. If an id is supplied, it will take priority and everything else will be ignored. No more than 10 authors. For adding more authors use the specific authors endpoint."
        items: {
          type: "object"
        }
      }
      categories: {
        type: "array"
        description: "List of category ids to be associated with the article(e.g [1, 23, 33, 66])"
        items: {
          type: "integer"
          format: "int64"
        }
      }
      categories_by_source_id: {
        type: "array"
        description: "List of category source ids to be associated with the article, supersedes the categories property"
        items: {
          type: "string"
        }
      }
      custom_fields: {
        type: "object"
        description: "List of key, values pairs to be associated with the article"
      }
      custom_fields_list: {
        type: "array"
        description: "List of custom fields values, supersedes custom_fields parameter"
        items: {
          type: "object"
          required: ["name", "value"]
          properties: {
            name: {
              type: "string"
              description: "Custom  metadata name"
            }
            value: {
              description: "Custom metadata value"
              type: "object"
            }
          }
        }
      }
      defined_type: {
        type: "string"
        description: "<b>One of:</b> <code>figure</code> <code>online resource</code> <code>preprint</code> <code>book</code> <code>conference contribution</code> <code>media</code> <code>dataset</code> <code>poster</code> <code>journal contribution</code> <code>presentation</code> <code>thesis</code> <code>software</code>"
      }
      description: {
        type: "string"
        description: "The article description. In a publisher case, usually this is the remote article description"
      }
      doi: {
        type: "string"
        description: "Not applicable for regular users. In an institutional case, make sure your group supports setting DOIs. This setting is applied by figshare via opening a ticket through our support/helpdesk system."
      }
      funding: {
        type: "string"
        description: "Grant number or funding authority"
      }
      funding_list: {
        type: "array"
        description: "Funding creation / update items"
        items: {
          type: "object"
          properties: {
            id: {
              type: "integer"
              format: "int64"
              description: "A funding ID as returned by the Funding Search endpoint"
            }
            title: {
              type: "string"
              description: "The title of the new user created funding"
            }
          }
        }
      }
      group_id: {
        type: "integer"
        format: "int64"
        description: "Not applicable to regular users. This field is reserved to institutions/publishers with access to assign to specific groups"
      }
      handle: {
        type: "string"
        description: "Not applicable for regular users. In an institutional case, make sure your group supports setting Handles. This setting is applied by figshare via opening a ticket through our support/helpdesk system."
      }
      is_metadata_record: {
        type: "boolean"
        description: "True if article has no files"
      }
      keywords: {
        type: "array"
        description: "List of tags to be associated with the article. Tags can be used instead"
        items: {
          type: "string"
        }
      }
      license: {
        type: "integer"
        format: "int64"
        description: "License id for this article."
      }
      metadata_reason: {
        type: "string"
        description: "Article metadata reason"
      }
      references: {
        type: "array"
        description: "List of links to be associated with the article (e.g [\"http://link1\", \"http://link2\", \"http://link3\"])"
        items: {
          type: "string"
          format: "link"
        }
      }
      resource_doi: {
        type: "string"
        description: "Not applicable to regular users. In a publisher case, this is the publisher article DOI."
      }
      resource_title: {
        type: "string"
        description: "Not applicable to regular users. In a publisher case, this is the publisher article title."
      }
      tags: {
        type: "array"
        description: "List of tags to be associated with the article. Keywords can be used instead"
        items: {
          type: "string"
        }
      }
      timeline: {
        type: "object"
        properties: {
          firstOnline: {
            type: "string"
            description: "Online posted date"
          }
          publisherAcceptance: {
            type: "string"
            description: "Date when the item was accepted for publication"
          }
          publisherPublication: {
            type: "string"
            description: "Publish date"
          }
        }
      }
      title: {
        type: "string"
        description: "Title of article"
      }
    }
  }
  output: {
    type: "object"
    required: ["entity_id", "location", "warnings"]
    properties: {
      entity_id: {
        type: "integer"
        format: "int64"
        description: "Figshare ID of the entity"
      }
      location: {
        type: "string"
        format: "url"
        description: "Url for entity"
      }
      warnings: {
        type: "array"
        description: "Issues encountered during the operation"
        items: {
          type: "string"
        }
      }
    }
  }
}