organizations.delete

Delete an organization

Request: DELETE/api/v1/organizations/{organizationSlug}
Scope required: organizations:write
Effect: Deletes something. Confirm with a person before calling it.
Acts on: Acts on an organization, and names it in the path.
MCP tool: organizations_delete
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Deletes the organization, its cohorts, its invitations and every note its staff wrote, and stops every board its applicants shared with it from being shared. No applicant loses any of their own data: the boards stay with the people who own them. This cannot be undone. Only an owner may call it, and an organization with a live subscription is refused with 409 until the subscription is cancelled. Answers 204 with no body. Cancel a live subscription first through `billing.create_portal_session`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
organizationSlug	path	Required	string

Response

Answers 204 with no body.

Examples

Close a career centre

Close a career centre — request

curl -s -X DELETE https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center \
  -H "Authorization: Bearer $JAT_KEY"

Close a career centre — response

null