Delete a client contact (permanent)
Delete a client contact (permanent). Requires Manager, Admin or Owner. Member tokens receive 403 forbidden_scope — Members have no client access in Hoursmith. Write scope. Hard delete; cannot be undone. Immediately blocks new client-portal sign-ins for that email and invalidates unused magic links, and a portal session that is already signed in ends on its next request. If it was the billing-default contact, invoice emails fall back to the client's general email. A repeated call returns 404.
Authorization
BearerAuth Personal Access Token. Mint at Settings → API. Token shape: hsk_<env>_<prefix12>_<secret32>.
In: header
Path Parameters
Client UUID.
Contact UUID.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}Update a client contact
Requires Manager, Admin or Owner. Member tokens receive 403 forbidden_scope — Members have no client access in Hoursmith. Write scope. Partial update: only supplied keys change. The contact must belong to the path client (else 404). Affects future invoice emails only. Confirmation rule (stateless, from the request alone): portalEnabled true requires confirmPortalAccess: true (the email may sign in to the client portal and see this client's invoices); isBillingDefault true requires confirmBillingDefault: true (invoice emails and automatic reminders default to this contact unless the client has its own billingEmail); on PATCH, supplying email requires confirmEmailChange: true. A missing acknowledgement is a 422 whose `fields` name the flag and why; nothing is changed. Turning a flag or portal access off never needs confirmation.
List projects
Any role. Member tokens see only projects they have been granted, and money/reconciliation fields (hourlyRate, fixedFeeAmount, fixedFeePriorInvoicedAmount, fixedFeeBillingInitializedAt, budgetAmount) are omitted from their responses.