Query all web host resources

POST

/web-hosts

Query and filter web host resources observed in the customer environment.

Relations:

employee (Person): The employee associated with this web host

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successful operation

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/web-hosts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "distinct_count": "string",
    "distinct_on": "host_name",
    "include_total_count": true,
    "limit": 10,
    "offset": 0,
    "query": "name='\''WINPC-4291'\'' AND status IN ('\''active'\'', '\''pending'\'')",
    "sort": "name desc, id"
}'

Response Example

200 - Example 1

{
    "distinct_values": [
        {
            "count": 0,
            "value": null
        }
    ],
    "pagination": {
        "count": 0,
        "total_count": 1000
    },
    "items": [
        {
            "allowlisted": true,
            "categories": [
                "AI Tools"
            ],
            "employee_email": "joe.smith@example.com",
            "employee_name": "Joe Smith",
            "event_types": [
                "corporate_email_login"
            ],
            "external_id": "chatgpt.com",
            "host": "chatgpt.com",
            "id": "8CA67511-744C-4D74-B26E-7281CF88712F",
            "last_seen": "2021-01-01T00:00:00Z",
            "login_count": 42,
            "risk_score": 9.2
        }
    ]
}

Modified at 2026-10-20 18:32:30

Get a remote machine by id

Get a web host resource by id