---
title: "Update custom item metadata for a node or preprint"
method: PATCH
path: "/custom_item_metadata_records/{guid_id}/"
tags: ["Custom Metadata"]
---

# Update custom item metadata for a node or preprint

`PATCH /custom_item_metadata_records/{guid_id}/`

Update an existing custom item metadata record for a node or preprint. Editable fields include language, resource type, and funding information.

## Path parameters

- `guid_id` string, required

## Request body

- object
  - `data` object, required
    - `type` string, required — The resource type.
    - `attributes` object, required
      - `language` string — The language of the content.
      - `resource_type_general` string — The general type of the resource.
      - `funders` object[] — Information about funding sources.
        - `funder_name` string, required
        - `funder_identifier` string
        - `funder_identifier_type` 'ISNI' | 'GRID' | 'Crossref Funder ID' | 'ROR' | 'Other'
        - `award_number` string
        - `award_uri` string
        - `award_title` string

## Response `200`

Successfully updated custom item metadata record.

## Other responses

- `400` — Validation error or invalid data.
- `401` — Authentication credentials were not provided or are invalid.
- `403` — You do not have permission to modify this metadata record.
- `404` — Metadata record not found.
- `405` — Returned if write access to the referenced project has been restricted (this restriction does not apply to metadata records associated with files). The response will include the message "This action is no longer available. Contact support if you have any questions."

## Changes

- **2026-08-20** `3c5164c707eb` — 1 info
  - added the non-success response with the status `405`

[Change history](https://skmtc.dev/osf/apis/osf-apiv2-documentation/changes/custom_item_metadata_records/:guid_id/patch.md)

---

[API](https://skmtc.dev/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.dev/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/3c5164c707eb/schema)
