Query IDE application instances.

POST

/ide/apps/instances

Query and filter IDE application instances.
An instance is an installation of an IDE application by a specific user.

Note that the risk score for an application instance is not the same as the application risk score.
The application risk score is the inherent risk of the application itself, while the instance risk score reflects the risk of that application being installed for that specific user.

Relations:

employee (Person): The person who installed the IDE application

application (IdeApplication): The IDE application installed

Additional Filters:

employee_organization (string): Filter by employee's organization/team

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

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/ide/apps/instances' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "distinct_count": "string",
    "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,
            "application_id": "030B484C-F0F3-46C7-B86A-9D02BF160DAA",
            "application_name": "GitHub Copilot",
            "employee_email": "joe.smith@example.com",
            "employee_name": "Joe Smith",
            "first_seen": "2021-01-01T00:00:00Z",
            "high_prevalence": true,
            "id": "8CA67511-744C-4D74-B26E-7281CF88712F",
            "risk_score": 9.2,
            "version": "1.145.0"
        }
    ]
}

Modified at 2026-03-31 19:28:57

Get an IDE application

List MCP servers