---
title: "Update article"
method: PUT
path: "/account/articles/{article_id}"
tags: ["articles"]
---

# Update article

`PUT /account/articles/{article_id}`

Update an article by passing full body parameters.

## Path parameters

- `article_id` integer, required

## Request body

- ArticleUpdate
  - `title` string — Title of article
  - `description` string — The article description. In a publisher case, usually this is the remote article description
  - `is_metadata_record` boolean — True if article has no files
  - `metadata_reason` string — Article metadata reason
  - `tags` string[] — List of tags to be associated with the article. Keywords can be used instead
  - `keywords` string[] — List of tags to be associated with the article. Tags can be used instead
  - `references` string[] — List of links to be associated with the article (e.g ["http://link1", "http://link2", "http://link3"])
  - `related_materials` RelatedMaterial[] — List of related materials; supersedes references and resource DOI/title.
    - `id` integer — The ID of the related material; can be used to add existing materials of the same account to items.
    - `identifier` string — The related material identifier (e.g., DOI, Handle, ISBN). Mandatory if creating a new material.
    - `title` string — The related material title
    - `relation` 'IsCitedBy' | 'Cites' | 'IsSupplementTo' | 'IsSupplementedBy' | 'IsContinuedBy' | 'Continues' | 'Describes' | 'IsDescribedBy' | 'HasMetadata' | 'IsMetadataFor' | 'HasVersion' | 'IsVersionOf' | 'IsNewVersionOf' | 'IsPreviousVersionOf' | 'IsPartOf' | 'HasPart' | 'IsPublishedIn' | 'IsReferencedBy' | 'References' | 'IsDocumentedBy' | 'Documents' | 'IsCompiledBy' | 'Compiles' | 'IsVariantFormOf' | 'IsOriginalFormOf' | 'IsIdenticalTo' | 'IsReviewedBy' | 'Reviews' | 'IsDerivedFrom' | 'IsSourceOf' | 'IsRequiredBy' | 'Requires' | 'IsObsoletedBy' | 'Obsoletes' — The relation between the item and the related material; defaults to 'References'. Mandatory if creating a new material.
    - `identifier_type` 'ARK' | 'arXiv' | 'bibcode' | 'DOI' | 'EAN13' | 'EISSN' | 'Handle' | 'IGSN' | 'ISBN' | 'ISSN' | 'ISTC' | 'LISSN' | 'LSID' | 'PMID' | 'PURL' | 'UPC' | 'URL' | 'URN' | 'w3id' — The type of the identifier of the related material; defaults to 'URL'. Mandatory if creating a new material.
    - `is_linkout` boolean — Flag for highlighting this related material in the call-out box
    - `link` string — The full hyperlink for the identifier. Automatically generated by Figshare.
  - `categories` integer[] — List of category ids to be associated with the article(e.g [1, 23, 33, 66])
  - `categories_by_source_id` string[] — List of category source ids to be associated with the article, supersedes the categories property
  - `authors` object[] — 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. For adding more authors use the specific authors endpoint.
  - `custom_fields` object — List of key, values pairs to be associated with the article
  - `custom_fields_list` CustomArticleFieldAdd[] — List of custom fields values, supersedes custom_fields parameter
    - `name` string, required — Custom metadata name
    - `value` union, required — Custom metadata value (can be either a string, an array of strings, or empty)
      - string
      - string[]
      - object
  - `defined_type` string — <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>
  - `funding` string — Grant number or funding authority
  - `funding_list` FundingCreate[] — Funding creation / update items
    - `id` integer — A funding ID as returned by the Funding Search endpoint. Use either id or title, not both.
    - `title` string — The title of the new user created funding. Use either title or id, not both.
  - `license` integer — License id for this article.
  - `doi` string — 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.
  - `handle` string — 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.
  - `resource_doi` string — Deprecated by related materials. Not applicable to regular users. In a publisher case, this is the publisher article DOI.
  - `resource_title` string — Deprecated by related materials. Not applicable to regular users. In a publisher case, this is the publisher article title.
  - `timeline` TimelineUpdate — Legacy timeline input (used by /v2/account/articles). Items with item-type based metadata do not use this object — pass dates as stock fields inside fields: {} instead.
    - `firstOnline` string — Online posted date
    - `publisherPublication` string — Publish date
    - `publisherAcceptance` string — Date when the item was accepted for publication
  - `download_disabled` boolean — If true, downloading of files for this article is disabled
  - `group_id` integer — Not applicable to regular users. This field is reserved to institutions/publishers with access to assign to specific groups

## Response `205`

Reset Content

- LocationWarningsUpdate
  - `location` string, url, required — Url for entity
  - `warnings` string[], required — Issues encountered during the operation

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/figshare/apis/figshare-api.md) · [All operations](https://skmtc.net/figshare/apis/figshare-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/figshare/figshare-api/versions/9dfb419f4430/schema)