Organizations

Create an Organization

post/v1/organizations

Request

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

Request body

namestring required

The name of the organization. Value cannot be blank and must be 256 characters or less.

keystring required

Organization keys are used to associate a Huntress Agent into a grouping. Value cannot be blank and must be 256 characters or less.

Example request

{
  "name": "Most Amazing Company, Ltd.",
  "key": "amazing"
}

Response

Create an Organization

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

No recorded changes to this operation across all 8 revisions of this API.