List available apps | Atomicwork

curl https://{tenant}.atomicwork.com/api/v1/iga/apps \
     -H "X-Workspace-Id: {{workspace_id}}" \
     -H "X-Api-Key: <apiKey>" \
     -H "Content-Type: application/json"

{
  "apps": [
    {
      "app_id": "app-9f8b7c6d-1234-4e56-8a9b-0c1d2e3f4a5b",
      "name": "Okta Identity Provider",
      "type": "Okta",
      "connected_at": "2024-05-10T15:22:30Z",
      "status": "active"
    },
    {
      "app_id": "app-4a3b2c1d-5678-4f90-b1a2-3c4d5e6f7g8h",
      "name": "Azure Active Directory",
      "type": "Azure AD",
      "connected_at": "2024-04-22T09:10:45Z",
      "status": "active"
    },
    {
      "app_id": "app-7e6f5d4c-9012-4b34-9c8d-7e6f5d4c3b2a",
      "name": "Google Workspace",
      "type": "Google Workspace",
      "connected_at": "2024-03-18T12:00:00Z",
      "status": "active"
    },
    {
      "app_id": "app-1a2b3c4d-3456-4e78-9f0a-1b2c3d4e5f6g",
      "name": "JumpCloud Directory",
      "type": "JumpCloud",
      "connected_at": "2024-02-28T08:45:15Z",
      "status": "active"
    }
  ],
  "page": 1,
  "per_page": 25,
  "total": 4
}

Typical flow: Call this endpoint first to get app_id values, then call GET /iga/entitlements?app_id={id} to browse the entitlements (groups, roles, licenses) available in each app.

Pagination: Supports page and per_page (default 25). Use search_key to filter apps by name.

List the identity resource apps connected to your workspace. This is the starting point for grant discovery — each app represents a connected identity provider (Okta, Azure AD, JumpCloud, Google Workspace, etc.) and contains entitlements that can be granted to users. **Typical flow:** Call this endpoint first to get `app_id` values, then call `GET /iga/entitlements?app_id={id}` to browse the entitlements (groups, roles, licenses) available in each app. **Pagination:** Supports `page` and `per_page` (default 25). Use `search_key` to filter apps by name.

Authentication

X-Api-Keystring

API Key authentication via header

Query parameters

search_keystringOptional>=1 character

Filter apps by name (partial match).

pageintegerOptionalDefaults to 1

Page number (1-indexed). Default 1.

per_pageintegerOptionalDefaults to 25

Results per page (default 25).

Response

Successful response

Authentication

Headers

Query parameters

Response