Skip to main content
DELETE
/
api
/
v1
/
credentials
/
{id}
Delete Credential
curl --request DELETE \
  --url https://api.example.com/api/v1/credentials/{id}
{
  "401": {},
  "403": {},
  "404": {},
  "412": {},
  "500": {},
  "affected": 123,
  "raw": [
    {}
  ]
}
Delete a credential from your workspace. This operation is irreversible.

​
Path Parameters

​
id
string
required
The unique identifier of the credential to delete

​
Response

​
affected
number
Number of credentials deleted (should be 1 if successful)
​
raw
array
Raw database response

​
Example Request

curl -X DELETE \
  'https://your-flowise-instance.com/api/v1/credentials/cred-789' \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Example Response

{
  "affected": 1,
  "raw": []
}

​
Important Warnings

Deleting a credential that is actively used in flows will cause those flows to fail. Make sure to:
  1. Check which flows use this credential
  2. Update or remove the credential from all flows
  3. Test affected flows after deletion

​
Before Deleting

Before deleting a credential:
  1. Identify all flows using this credential
  2. Either:
    • Update flows to use a different credential, or
    • Remove the credential requirement from flows
  3. Ensure no active executions are using the credential

​
Recovery

Deleted credentials cannot be recovered. If you accidentally delete a credential:
  1. Create a new credential with the same configuration
  2. Update all affected flows to use the new credential
  3. Test the flows to ensure they work correctly

​
Error Responses

​
401
error
Unauthorized - Invalid or missing API key
​
403
error
Forbidden - Insufficient permissions to delete credentials
​
404
error
Not Found - Credential with specified ID not found or workspace not found
​
412
error
Precondition Failed - Missing required ID parameter
​
500
error
Internal Server Error - Error deleting credential

Build docs developers (and LLMs) love

Get started for freeTalk to us