v4

latestOpenAPI 3.1.02026-08-02261331761.5 KB

Organizations

Delete Organization

Schedules an organization (Permit.io account) for permanent deletion.

Effective immediately, the organization disappears from GET /v2/orgs (list) and direct lookups (GET /v2/orgs/{id}); subsequent PATCH and DELETE calls on it return 404. To preserve recoverability during the grace period, member grants and existing API keys are intentionally retained — support can restore the organization until the cutoff is reached. After the grace period the organization and all of its data are permanently removed.

Contract change: This endpoint previously returned 204 No Content with an empty body and an immediate hard-delete. It now returns 202 Accepted with a JSON body describing when the permanent deletion will occur. Existing clients that branched on status == 204 need to be updated.

Error responses are documented in the OpenAPI responses block above.

delete/v2/orgs/{org_id}

Path parameters

org_idstring required

Either the unique id of the organization, or the URL-friendly key of the organization (i.e: the "slug").

Response

Successful Response

status'scheduled'

deleted_atstring date-time required

Timestamp when the deletion was scheduled

delete_afterstring date-time required

Timestamp when the org will be permanently deleted

Example response

{
  "status": "scheduled",
  "deleted_at": "2026-04-30T12:00:00+00:00",
  "delete_after": "2026-05-10T12:00:00+00:00"
}