HUhuntress
Organizations

Delete an Organization

Changed on

Deletes the specified Organization.

Please note: This will remove the organization and associated configurations across the Huntress Platform, including Managed SAT. For more information, see our offboarding guide.

delete/v1/organizations/{id}

Request

  • Base URL
    https://api.huntress.io
  • URL
    https://api.huntress.io/v1/organizations/{id}
  • Auth
    basic (a scheme the document does not define)

Path parameters

idinteger required

The id of the organization to be deleted

Query parameters

revoke_keyboolean

Whether to also revoke the Organization's key. When true, any GPOs, scripts, or RMM templates referencing this key will stop registering agents after deletion. All revoked organization keys can be found in your Account Settings.

Response

Organization deleted

Example response

{
  "organization": {
    "id": 1,
    "agents_count": 42,
    "account_id": 5,
    "created_at": "2022-03-01T18:54:02Z",
    "incident_reports_count": 42,
    "key": "test1",
    "logs_sources_count": 42,
    "identity_provider_tenant_id": "dcd219dd-bc68-4b9b-bf0b-4a33a796be35",
    "billable_identity_count": 42,
    "name": "Acme Inc.",
    "report_recipients": [
      "test@test.com",
      "fakenotificiation@test.com"
    ],
    "sat_learner_count": 42,
    "updated_at": "2022-03-01T18:54:02Z"
  }
}

Changes

  • ef3bb6b21e7aRevision changes
    • info

      added the new optional query request parameter revoke_key

    • info

      added the non-success response with the status