---
id: workflow-config-delete
title: Delete a secret or variable
description: Deletes the entry and its stored value.
sidebar_label: Delete a secret or variable
hide_title: true
hide_table_of_contents: true
api: >-
  eJydVm1P20gQ/iur+VKqM05aceqdv3GUSlR3PURBVEIo2XjH8RZ7d7s7BqLI/72atWMcSIG7fIntnZdnZp6Z2TWQXAbIruDS+puisnciYO6RgpBGiVvptVxUGOA6AYUh99qRtgYy+IgVEgZBJQo05FdRQVMQgaxH1q0aTCEB69BL1jpRkMFd72c/t6bQy0xFO5CAk17WSOgZzho0O3GSSkjAyBohA60gAY8/Gu1RQUa+wQRCXmItIVsDrRxLBfLaLKF9DPi8RNH57PFqJfbmebGcpWk6f8tI8V7WrmIj/Pn94k/1rphKaK8TCJg3XtMqYlug9OgPGyohu7rmY4/BWRMwMJD30wP+e+q+83sng+iiVinDPPj27an4UaXRkEDvrU+EDMJVUhvx+eu/Xxhpbg2hIdaTzlU6jwmefA+svB4nRVMM6ChGfszmINmkyi6+Y06wK1PRsVhYtdoQYl8atT8QQqBRzmpDQXikxptMSFHLvNQG9z1KxVIitwqFq5rAhxiCXEZGOM+cIN2lK7p6WsDHqP7ZZTwRmC5TMdfmVlZazZgp8+Th3VUyjx+6IGZFJZczXdcNsQk+MJZmhW2Mmm8zYMsCl6nHvwvog9apt7daocB7mVO1EtagsIVgHgvrxYb80MZfAr/vqv2FwXuHOaESAf0t+q4az9TdebuosP7t1/U/7SReVftA0ijp1ZgEe2efjsSHP6YfRO9LKCSpq5B0GBVzdP4rTF17bZe9w/FS1SNjBcuIi7OTTblLIheyyWQYJmEVCOtU4e0kgg4PR8bS/q4C/y8bTIQ+pc/R4IslMcgHktSMQgZtCJfoxxoH04M4sDilL5keWCTuNJU8xu6KmS4u/1pcFq5ZTo3Aex0osG9tuJj5C3CHQMNEYaGN5uSHySOzbK9LzMia9F6unlTt1GPg8WWNiF0UGSEKqavGY8hiW3TD0KEXtijQKG2WotBYKS6TJqzHbga2bnMo7ofnQwuELkxCLs2km/6v7uW6CSRKeYtis3NE730l3vDwedO3cdfKNVJpecONNhqjG2e3QzBZa9UC7xRu7m7dNb4acVI6nZqmqlwlqbC+TnNbb62hr9zgXQ7Gy2gIhw1Bvxz5vROCpH/4ZH0tCTL4fHkObeRJYVmd8XQlfJdO0ykMbIcvIzji8PSE0+hsoFrGidOv6O5WIGS/NHjmbVbGY5KsH4bZf7hM9PER3tMkrkTGEZO3YcPVcMUI3cDkmieQacWXmNIGYpn1eiEDXviqbfnzjwY97/brBAa8XBalAz8ryApZBXwmhL2zniRvxStuGjvD2LSU4YaKEUMGkMANrrrbT3vdJlCiVOgjuu7gMM/R0UjlyY2AmTPQ8+Px38fnx5CA3KbMI4pEBzsRrdedxLm9QdO2A0Did8bYtj8BM7eX0Q==
sidebar_class_name: delete api-method
info_path: docs/api/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-config-delete'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Delete a secret or variable"}
>
</Heading>

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

</MethodEndpoint>

Deletes the entry and its stored value.

<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={undefined}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"204":{"description":"The entry was deleted."},"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>