Pacts

Delete a draft

Delete a pact that was never sent. A sent pact is voided instead, so its record stays.

DELETE/v1/pacts/{uid}

Authorization

Authorizationstringheaderrequired

Bearer followed by your API key: Bearer sgk_…. The key also works in an X-Api-Key header. See Authentication.

Path parameters

uidstringpathrequired

The pact's 8-character id. Not case-sensitive.

Response

204 No ContentDeleted. There is no body.

Errors

Status	When
401 Unauthorized	The API key is missing, wrong or revoked.
403 Forbidden	The account's plan does not include API access (Pro and Business do).
404 Not Found	No pact with that id belongs to your account.
409 Conflict	The pact is not a draft.

Every error body is { "error": "message" }. See Errors.

Request

curl -X DELETE https://api.signwithsigil.com/v1/pacts/K4TQ7MZE \
  -H "Authorization: Bearer $SIGIL_API_KEY"

const res = await fetch('https://api.signwithsigil.com/v1/pacts/K4TQ7MZE', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SIGIL_API_KEY}` },
});
console.log(res.status); // 204

import os
import requests

res = requests.delete(
    "https://api.signwithsigil.com/v1/pacts/K4TQ7MZE",
    headers={"Authorization": f"Bearer {os.environ['SIGIL_API_KEY']}"},
)
print(res.status_code)  # 204

Response

204 No ContentThe response has no body.

{
  "error": "Only a draft can be deleted. Void a sent pact instead."
}