---
title: "Update secret metadata"
method: PUT
path: "/vault/v1/api/{teamId}/secrets/{secretId}/metadata"
tags: ["Vault"]
---

# Update secret metadata

`PUT /vault/v1/api/{teamId}/secrets/{secretId}/metadata`

## Request

- Base URL: `/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/vault/v1/api/{teamId}/secrets/{secretId}/metadata`
- Auth: API key in header `Authorization` and API key in header `x-smyth-team-id`
- TypeScript: <https://skmtc.dev/smythos/apis/smyth-api/docs/vault/v1/api/:teamId/secrets/:secretId/metadata/put.ts> (a function with typed inputs; its response is checked against the schema)

Update metadata for a specific vault secret

## Path parameters

- `teamId` string, required
- `secretId` string, required

## Request body

- VaultSecretMetadataRequest
  - `metadata` object, required: Secret metadata

## Response `200`

Metadata updated successfully

- ResponseMessage
  - `message` string

## Other responses

- `400`: Invalid request data

---

[API](https://skmtc.dev/smythos/apis/smyth-api.md) - [All operations](https://skmtc.dev/smythos/apis/smyth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smythos/apis/smyth-api/revisions/1475e078fb4a?raw)