Delete a Credential

Path

DELETE /api/v1/forward/vaults/{id}/credentials/{cred_id}

Request headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or SAT>`

Forward verifies that the caller owns the Vault before deleting the Credential.

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	Vault ID.
`cred_id`	string	Yes	Credential ID.

Example request

curl -X DELETE "https://api.qoder.com/api/v1/forward/vaults/vault_xxx/credentials/vcred_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

{
  "id": "vcred_xxx",
  "type": "vault_credential_deleted",
  "deleted": true
}

Response fields

Field	Type	Description
`id`	string	ID of the deleted resource.
`type`	string	Deletion result type.
`deleted`	boolean	Whether the resource was deleted.

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	The request body, path parameters, or pagination parameters are invalid, including an invalid `auth` object, such as `static_bearer` without `token`.
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	The caller cannot access the parent Vault or Credential.
404	`not_found_error`	The Vault or Credential does not exist or is not visible.
409	`conflict_error`	The Credential state conflicts with the operation.
500/502/503	`api_error`	Forward or a dependent service failed.

Authentication data in Credential requests is sensitive. Some detailed validation messages are replaced with a generic redacted message; the HTTP status and error type remain unchanged.

​Path

​Request headers

​Path parameters

​Example request

​Example response

​Response fields

​Errors

Path

Request headers

Path parameters

Example request

Example response

Response fields

Errors