---
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: eJydVm1v20YM/ivEfVnqKbJbZOimb2mbAi22LmhTpEAbxGcdZV1zulOPlBPP8H8feJIdJ3HTbv5iSccjH5IPX1aK9ZxU8Vmdh3hVuXANhGVEJtDewEJHq2cOSV1kyiCV0bZsg1eFeoUOGQm4RkDPcZkuWCYgDhHlruswV5kKLUYtt94YVajrwc5hGXxl54VJelSmWh11g4xR4KyUFSOt5lplyusGVaGsUZmK+K2zEY0qOHaYKSprbLQqVoqXrUgRR+vnan0f8FmN0Nsc8FoDB9Oyml/meT59IkjxRjetEyXy+dnsD/O0mmi1vsgUYdlFy8uEbYY6YjzuuFbF5ws5jkht8IQkQJ5NjuTvofne7rUm6L02ucA8+vTpofhLZ9EzYIwhZqAJWqeth7cf/n4nSMvgGT3LPd22zpYpwOOvJJdXu0GxnBx6mTw/EXUq24QqzL5iyWpfpJJhmAWz3BDiUHtzuCUEoDdtsJ4JInIXfQEaGl3W1uNhRG1ECspgEFrXkRwikZ4nRrRROMG2D1cy9TCB91H9tU95BpjPc5hav9DOmkthyjS7fW+dLtOH3onLyun5pW2ajkWFHPjAl1XovJneZcAdDZKmAf8+oLe3TmNYWIOAN7pkt4TgEUIFwmMIETbkV+v0y9Rv+3L/0eNNiyWjAcK4wNhn45G8tzHMHDa/fj//p73ET+WeWHujo9klwcH71y/h+e+T5zDYAoOsraOsx2iEo9PvYerL627aexw/ynpiLIgMfHz/ZpPumrmlYjzeNhNaEmOTG1yME2i6PfKBD/cl+H/pECIMIX2MBu8Cw1aeWHO347KynnGOcffG0eQoNSwJ6Y9Ub1kE15ZraWPX1aWtzl/Mzqu2m0884I0lJrFtvSSz/AHcraM0NlhZbyX4NL6nVvT1gdnRpmPUywdZO41I0r6Ch1RFiRFQaeu6iFSksuibYYsRQlWhN9bPobLojKTJMja7ZrZsvcuhNB8ed40YWxpTqf247/4/XctNRwy1XiBsZg4M1pfwizSfX4Yy7ku5Qa6DTLidiSbodqPbIxivrFkrmSlS3P2466Lb4aRube4751qnuQqxycvQ3BlDH6TA+xjsDqOtO6JIDcNR3nshlQ0Pr0NsNKtCvT0/U+vEkyrstovNNkAqU4KxT+skf5pPHiT7RWedyaDtZs5SnUHsfJaWgTBLHm75SsIH2Rd2XbtlM/q59Zh/8V/869BFsAY1QYhz7e0/CFxbguPTN4UIHMJo9OqWqqMR6IhJ91adCWXXoGfK4WSBcQkkqZxhGRqUeeS7ZoaS1NEo4sKKi6NRBhTAB66FjZYApfu6QJz3No+d1YQbezJtDKQxiJGAA2jY6IIDZ68Qps4ucPokh+OS7UKz6NUetOgRA9e1ZpD5SWl34mjnc9EV/GDx5AbLbuNkxDJIX07+pDgLvWG2TP/Z0BB82zFlEDruHyQXLsxp0Phh34I3GsEVYgtlRIOerXa9ACELZhJtMskkxLc9Iu0vbSBudJo7w6LW74agh9VBJt/G0H32rG5H2n9YKQeWM97wOC1GgiOV0KYnfN4umtSPTan8TBXWyCpbB2KRWa1mmvBjdOu1fP7WYZQN7yJTW7xSnMaSPBtVVNoRPuLCwfuhVTyBn9g397qxaaxe2mryWBVKZeoKl/0OvL5YZ6pGbTAmdP3BcVliyztXHuyF0j+2TerVyZ8nZycqU/pu47jXKJKBvYhWq17iLFyhX6+3AFneBeN6/S/EhlCk
sidebar_class_name: "delete api-method"
info_path: docs/api/workflows
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<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>