---
title: "Parse a given XML metadata record and update the component."
method: POST
path: "/datacatalog/api/component/{id}/parse-metadata"
tags: ["Data Release"]
---

# Parse a given XML metadata record and update the component.

`POST /datacatalog/api/component/{id}/parse-metadata`

## Request

- Base URL: `https://data.usgs.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://data.usgs.gov/datacatalog/api/component/{id}/parse-metadata`
- Auth: OAuth 2
  - Authorization code: `https://auth.globus.org/v2/oauth2/authorize?scope=openid`
  - Token URL: `https://data.usgs.gov/datacatalog/api/auth/login`

Parse metdata file and update component.

A valid bearer token is required.

:param id: The ID of the component.
:param data: ParseMetadataRequest containing the file_name of the metadata.
:param token: A valid bearer token for the user.

## Path parameters

- `id` string, required

## Request body

- ParseMetadataRequest
  - `file_name` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation.md) - [All operations](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/revisions/f5f6a07ba13f?raw)