Delete credential

DELETE https://app.sulus.ai/api/tools/credentials/{id}

Delete an owned credential (live platform, then locally)

Authentication

Send a bearer token created on your dashboard's Developer page:

Authorization: Bearer <YOUR_API_KEY>

Path parameters

id string Required

The credential's public id.

Validation: the credential's public id, owned by the authenticated user

Errors

Status	Meaning	Body
`401`	No authenticated user	`{"success":false,"message":"Unauthenticated."}`
`404`	Credential not found, or not owned by the caller	`{"success":false,"message":"Credential not found."}`
`502`	Live delete failed — local row is kept	`{"success":false,"message":"<cleaned upstream error>"}`
`403`	Feature tools not enabled for the account

Notes

Unlike tools, a credential's local row is only removed after the live delete succeeds — a tool still referencing this credential's server.credentialId will start failing its calls.

curl --request DELETE \
  --url https://app.sulus.ai/api/tools/credentials/{id} \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

import requests

url = "https://app.sulus.ai/api/tools/credentials/{id}"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}

response = requests.delete(url, headers=headers)
print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://app.sulus.ai/api/tools/credentials/{id}"
	req, _ := http.NewRequest("DELETE", url, nil)
	req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

Response 200

{
    "success": true,
    "message": "Credential \"Orders API\" deleted."
}

{
    "success": true,
    "message": "Credential \"Orders API\" deleted."
}