Endpoint Reference

Each endpoint includes method, path, parameters, and examples.

Users

GET /users

• List all users

GET /users/{id}

• Get details for a specific user

---

Workapps

GET /workapps

• List all discovered applications

GET /workapps/discover

• Trigger discovery scan (read-only for now)

GET /workapps/{id}

• Get metadata about an application

GET /workapps/{id}/status

• Check status of a workapp (e.g. managed, shadow IT)

GET /workapps/{id}/users

• List users with access to a workapp

POST /workapps/{id}/users

• Assign a user to a workapp

GET /workapps/{id}/users/recentlydeleted

• Recently offboarded users (P1 priority)

GET /workapps/{id}/permissionLevels

• List permission levels defined for a workapp

GET /workapps/{requestType}/policy

• Retrieve policy definition for request type

---

Policies

GET /policies

• List all policies

GET /policies/{id}

• Get a specific policy by ID

---

Tasks

PATCH /tasks/{id}

• Mark a task as complete

{
  "status": "complete",
  "completed_by": "user_abc"
}

---

Applications

GET /applications/{id}/custom_fields

• Retrieve custom metadata fields for an application