Resign a director

DELETEhttps://app.speybooks.com/api/v1/directors/{id}

Retires a director: marks the record inactive and stamps the resignation date with the current date if one is not already recorded, preserving any existing date. The endpoint takes no request body. Only an active director can be resigned; a director who is already inactive is reported as not found. The updated record is returned, and it is kept for historical reporting.

Path parameters

idstringrequired

Director ID (e.g. dir_1). Must use the director prefix.

Response

200Director resigned. Sets active to false and resigned_date to today if not already set. Returns the updated director.

Show response fields

activeboolean

fullNamestring

idstring

resignedDatestring

Error codes

400Invalid ID format.

404Active director not found.

RequestDELETE/v1/directors/{id}curl

curl -X DELETE https://api.speybooks.com/v1/directors/dir_2 \
  -H "Authorization: Bearer sk_test_..."

Response200

{
  "success": true,
  "data": {
    "id": "dir_2",
    "fullName": "Sandra Reid",
    "active": false,
    "resignedDate": "2026-03-31"
  }
}