Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Huntress Reseller API

Operations for Reseller-level API credentials. These are mostly the same endpoints available in the rest of the API. However, the account ID is included in the URL, so that you can specify which account's resources you want to access.

Huntress Reseller API is one of 17 APIs that Huntress publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reseller. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 46 operations across 32 paths, and defines 35 schemas. It is described by OpenAPI 2.0, at version 1.0.0.

Requests are made against the base URL https://api.huntress.io/v1.

46 operations 32 paths 35 schemas 5 DELETE27 GET5 PATCH9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0.0
Base URL
https://api.huntress.io/v1
Authentication
basic
Resource Areas
1

Authentication & Security 1

Huntress Reseller API declares 1 security scheme for authenticating requests. It defines a basic scheme (basic_auth). By default, every request must be authenticated.

Paths & Operations 46

Across 32 paths, the API surfaces 46 operations — 5 DELETE, 27 GET, 5 PATCH, 9 POST. Each is listed below with its method, path, parameters, and response codes.

Reseller 46

Operations for Reseller-level API credentials. These are mostly the same endpoints available in the rest of the API. However, the account ID is included in the URL, so that you ca…

GET
/v1/reseller/invoices
List Reseller Invoices
getV1ResellerInvoices 3 params → 200400403
GET
/v1/reseller/invoices/{id}
Get Reseller Invoice
getV1ResellerInvoicesId 1 param → 200403404
GET
/v1/reseller/invoices/{id}/account_usage_line_items
List Account Usage Line Items
getV1ResellerInvoicesIdAccountUsageLineItems 3 params → 200403
GET
/v1/reseller/invoices/{id}/organization_usage_line_items
List Organization Usage Line Items
getV1ResellerInvoicesIdOrganizationUsageLineItems 3 params → 200403
GET
/v1/reseller/subscriptions
List Reseller Subscriptions
getV1ResellerSubscriptions 6 params → 200400403
POST
/v1/reseller/subscriptions
Create Reseller Subscription
SubscriptionCreationParameters 1 param → 201400404422
GET
/v1/reseller/subscriptions/{id}
Get Reseller Subscription
getV1ResellerSubscriptionsId 1 param → 200400404
PATCH
/v1/reseller/subscriptions/{id}
Update Reseller Subscription
SubscriptionUpdateParameters 2 params → 200400404409422
POST
/v1/reseller/subscriptions/{id}/upgrade
Upgrade Reseller Subscription
SubscriptionUpgradeParameters 2 params → 201400404422
GET
/v1/accounts
List Accounts
getV1Accounts 7 params → 200403
POST
/v1/accounts
Create Account
AccountCreationParameters 1 param → 201400403409422
GET
/v1/accounts/{account_id}
Get Specific Account
getV1AccountsAccountId 1 param → 200403
PATCH
/v1/accounts/{account_id}
Update Account
AccountUpdateParameters 2 params → 200403422
DELETE
/v1/accounts/{account_id}
Permanently Disable an Account
deleteV1AccountsAccountId 1 param → 202403422
GET
/v1/accounts/{account_id}/agents
List Agents
getV1AccountsAccountIdAgents 10 params → 200403
GET
/v1/accounts/{account_id}/agents/{id}
Get Agent
getV1AccountsAccountIdAgentsId 2 params → 200403
PATCH
/v1/accounts/{account_id}/agents/{id}
Update Agent
UpdateAgent 3 params → 200403404409
DELETE
/v1/accounts/{account_id}/agents/{id}
Uninstall Agent
UninstallAgent 2 params → 204403404
POST
/v1/accounts/{account_id}/agents/{id}/isolation
Isolate Agent
IsolateAgent 3 params → 201403404409
DELETE
/v1/accounts/{account_id}/agents/{id}/isolation
Release Agent Isolation
ReleaseAgent 2 params → 204404409
GET
/v1/accounts/{account_id}/external_ports
List External Ports
getV1AccountsAccountIdExternalPorts 10 params → 200403
GET
/v1/accounts/{account_id}/external_ports/{id}
Get External Port
getV1AccountsAccountIdExternalPortsId 2 params → 200403
GET
/v1/accounts/{account_id}/invoices
List Account Invoices
getV1AccountsAccountIdInvoices 7 params → 200403
GET
/v1/accounts/{account_id}/invoices/{id}
Get Account Invoice
getV1AccountsAccountIdInvoicesId 2 params → 200403
GET
/v1/accounts/{account_id}/incident_reports
List Incident Reports
getV1AccountsAccountIdIncidentReports 11 params → 200403
GET
/v1/accounts/{account_id}/incident_reports/{id}
Get Incident Report
getV1AccountsAccountIdIncidentReportsId 2 params → 200403
POST
/v1/accounts/{account_id}/incident_reports/{id}/resolution
Create an Incident Report Resolution
postV1AccountsAccountIdIncidentReportsIdResolution 2 params → 201403409422
GET
/v1/accounts/{account_id}/memberships
List Memberships
getV1AccountsAccountIdMemberships 8 params → 200403
POST
/v1/accounts/{account_id}/memberships
Create a Membership
MembershipCreationParameters 2 params → 201400403404422
GET
/v1/accounts/{account_id}/memberships/{id}
Get Membership
getV1AccountsAccountIdMembershipsId 2 params → 200403
DELETE
/v1/accounts/{account_id}/memberships/{id}
Delete Membership
deleteV1AccountsAccountIdMembershipsId 2 params → 202403404422
PATCH
/v1/accounts/{account_id}/memberships/{id}
Update a User's membership
MembershipUpdateParameters 3 params → 200400403422
GET
/v1/accounts/{account_id}/organizations
List Organizations
getV1AccountsAccountIdOrganizations 7 params → 200403
POST
/v1/accounts/{account_id}/organizations
Create an Organization
OrganizationCreationParameters 2 params → 201400403422
GET
/v1/accounts/{account_id}/organizations/{id}
Get Organization
getV1AccountsAccountIdOrganizationsId 2 params → 200403
PATCH
/v1/accounts/{account_id}/organizations/{id}
Update an Organization
OrganizationUpdateParameters 3 params → 200400403422
DELETE
/v1/accounts/{account_id}/organizations/{id}
Delete an Organization
deleteV1AccountsAccountIdOrganizationsId 2 params → 202403404409422
GET
/v1/accounts/{account_id}/incident_reports/{incident_report_id}/remediations
List Remediations
getV1AccountsAccountIdIncidentReportsIncidentReportIdRemediations 8 params → 200403
GET
/v1/accounts/{account_id}/incident_reports/{incident_report_id}/remediations/{remediation_id}
Get Remediation
getV1AccountsAccountIdIncidentReportsIncidentReportIdRemediationsRemediationId 3 params → 200403
POST
/v1/accounts/{account_id}/incident_reports/{incident_report_id}/remediations/bulk_approval
Bulk Approve Remediations
postV1AccountsAccountIdIncidentReportsIncidentReportIdRemediationsBulkApproval 2 params → 201403409422
POST
/v1/accounts/{account_id}/incident_reports/{incident_report_id}/remediations/bulk_rejection
Bulk Reject Remediations
RemediationBulkRejectionParameters 3 params → 201403409422
GET
/v1/accounts/{account_id}/reports
List Summary Reports
getV1AccountsAccountIdReports 9 params → 200403
GET
/v1/accounts/{account_id}/reports/{id}
Get Summary Report
getV1AccountsAccountIdReportsId 2 params → 200403
GET
/v1/accounts/{account_id}/signals
List Signals
getV1AccountsAccountIdSignals 12 params → 200403
GET
/v1/accounts/{account_id}/signals/{id}
Get Signal
getV1AccountsAccountIdSignalsId 2 params → 200403
GET
/v1/actor
Get Actor
getV1Actor → 200403

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are SummaryReport (80 properties), Agent (33 properties), IncidentReport (17 properties), OrganizationWithActualProductUsages (14 properties). Each schema is shown below with its type and property counts.

SubscriptionUpgradeParameters
object
Upgrade Reseller Subscription
3 properties 1 required
Subscription
object
Subscription model
11 properties
OrganizationWithActualProductUsages
object
OrganizationWithActualProductUsages model
14 properties 3 required
Account
object
Account model
8 properties
SubscriptionCreationParameters
object
Create Reseller Subscription
5 properties 4 required
Agent
object
Agent model
33 properties
Address
object
6 properties
OrganizationUpdateParameters
object
Update an Organization
3 properties
AccountUsageLineItem
object
AccountUsageLineItem model
7 properties
IncidentReport
object
IncidentReport model
17 properties
AccountUpdateParameters
object
Update Account
6 properties
ReportIncidentRemediation
object
2 properties
MembershipUpdateParameters
object
Update a User's membership
1 property
Remediation
object
Remediation model
8 properties
OrganizationUsageLineItem
object
OrganizationUsageLineItem model
6 properties
AccountCreationParameters
object
Create Account
11 properties 4 required
User
object
3 properties
Actor
object
Actor model
3 properties
ReportExternalService
object
2 properties
Organization
object
Organization model
13 properties 3 required
ExternalPort
object
ExternalPort model
9 properties
SummaryReport
object
SummaryReport model
80 properties
UpdateAgent
object
Update Agent
2 properties
Pagination
object
Pagination model
2 properties
Membership
object
Membership model
7 properties
IsolateAgent
object
Isolate Agent
2 properties
MembershipCreationParameters
object
Create a Membership
5 properties 4 required
SubscriptionUpdateParameters
object
Update Reseller Subscription
5 properties
SubscriptionSchedule
object
9 properties
MemberInvitation
object
MemberInvitation model
4 properties
Signal
object
Signal model
11 properties
RemediationBulkRejectionParameters
object
Bulk Reject Remediations Remediations
5 properties 2 required
Invoice
object
Invoice model
10 properties
ReportIncident
object
6 properties
OrganizationCreationParameters
object
Create an Organization
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

huntress-reseller-api-openapi.yml Raw ↑

Other APIs Huntress publishes across the network.

Huntress Accounts API
Huntress Actor API
Huntress Agents API
Huntress Escalations API
Huntress External Recon API
Huntress Identities API
Huntress Incident Reports API
Huntress Invoices API
Huntress Known VPNs API
Huntress Organizations API
Huntress Platform Actions API
Huntress SIEM API