---
search:
  tags:
    - secrets
    - PUT
seo:
  description: >-
    Creates the secret or replaces its value, bumping version either… Reference
    for the PUT /v1/machines/{machine_id}/secrets endpoint in the Computer API
    API.
sidebar:
  badge: PUT
  label: store a secret for the machine
title: store a secret for the 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" />