---
id: workflow-config-rotate
title: Rotate a value
description: >-
  Replaces the entry's value in place. Name, place, and the secret flag are
  unchanged.
sidebar_label: Rotate a value
hide_title: true
hide_table_of_contents: true
api: >-
  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
sidebar_class_name: patch api-method
info_path: docs/api/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-config-rotate'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Rotate a value"}
>
</Heading>

<MethodEndpoint
  method={"patch"}
  path={"/workflows/config/{id}"}
  context={"endpoint"}
>

</MethodEndpoint>

Replaces the entry's value in place. Name, place, and the secret flag are unchanged.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"The config entry id (`cfg_...`).","example":"cfg_2b9d1f0a"}]}
>

</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","required":["value"],"properties":{"value":{"type":"string"}}}}}}}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The value was rotated.","content":{"application/json":{"schema":{"title":"ConfigEntry","type":"object","description":"A secret or variable. Exactly one of `path` or `workflow` identifies the place it lives. Secret values are write-only: they are never returned by any read.","required":["id","name","secret","createdAt","updatedAt"],"properties":{"id":{"type":"string","example":"cfg_2b9d1f0a"},"name":{"type":"string","description":"Referenced in definitions as `${{ secrets.NAME }}` or `${{ vars.NAME }}`.","example":"NP_API_KEY"},"secret":{"type":"boolean","description":"Immutable. `true` makes the value write-only and redacted everywhere."},"path":{"type":"string","description":"Folder place (`/` is the organization root). Present when the entry lives on a folder.","example":"/action-items"},"workflow":{"type":"string","description":"Workflow reference. Present when the entry lives on one workflow."},"value":{"type":"string","nullable":true,"description":"Only returned for non-secret entries."},"effective":{"type":"boolean","description":"Only with `ancestors=true`: whether this row wins precedence for its name."},"mode":{"type":"string","enum":["created","updated"],"description":"Write responses only: whether the entry was created or its value rotated."},"createdBy":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}},"4XX":{"description":"Client error, as plain JSON.","content":{"application/json":{"schema":{"title":"ConfigError","type":"object","description":"The error body secrets-and-variables endpoints return: a machine-readable code plus a message.","properties":{"error":{"type":"string","description":"Machine-readable code, e.g. `invalid_name`, `invalid_place`, `secret_flag_immutable`, `not_found`.","example":"invalid_place"},"message":{"type":"string","example":"Provide exactly one of path or workflow"}}}}}},"5XX":{"description":"Unexpected server error.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}}}}
>

</StatusCodes>