---
search:
  tags:
    - Secrets
    - PUT
seo:
  description: >-
    Creates the secret or replaces its value, bumping version either way.…
    Reference for the PUT /v1/machines/{machine_id}/secrets endpoint in the
    Raster API API.
sidebar:
  badge: PUT
  label: Store a secret on a machine
title: Store a secret on a machine
type: openapi-operation
---
Creates the secret or replaces its value, bumping `version` either way. A running machine takes delivery within seconds; a stopped one takes it on the next boot.

<Operation source="api" id="secrets-set" />