The browsers of a connected user

GET

/v1/users/{user_ref}/installs

const url = 'https://api.eu.apigami.com/v1/users/example/installs';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.eu.apigami.com/v1/users/example/installs \
  --header 'Authorization: Bearer <token>'

Every browser attached to the user that your app can reach, by the references your team sees, in one answer. A user_ref of another team, or of a user not connected to this app, answers the same 404. Your API key works here, and so does the production version’s APIGAMI_KEY in code Apigami hosts.

Authorizations

apiKey

Parameters

Path Parameters

user_ref

required

string

Responses

200

The user’s browsers, most recently seen first. next is always null: one person’s browsers fit one answer.

application/json

object

installs

required

Array<object>

object

user_ref

The person this browser is attached to.

string

install_ref

string

label

The name the user gave that browser.

string | null

flavor

string

Allowed values: standard devtools

online

Holds a live connection right now.

boolean

presence

The status extension.online and extension.offline announce, which ignores brief interruptions.

string

Allowed values: online offline

presence_changed_at

string format: date-time

last_seen_at

string format: date-time

granted_domains

Among the sites this browser lets Apigami access, those the user approved for your app. Null for an older install that does not report them.

Array<string> | null

connected_at

When the person connected to your app.

string format: date-time

next

required

null

Example

{
  "installs": [
    {
      "user_ref": "usr_3f9c1a0e7b2d4c58a61e9f0b2d7c4e13",
      "install_ref": "ins_8b1e4f2a9c3d4e5f8a7b6c5d4e3f2a1b",
      "label": "Work laptop",
      "flavor": "standard",
      "online": true,
      "presence": "online",
      "presence_changed_at": "2026-09-27T08:02:11.000Z",
      "last_seen_at": "2026-09-27T09:41:05.000Z",
      "granted_domains": [
        "example.com"
      ],
      "connected_at": "2026-09-01T08:00:00.000Z"
    }
  ],
  "next": null
}

401

Missing, malformed or revoked API key, or the key of a version that is not in production.

application/json

object

error

required

string

consentPending

Present and true when the approval window is open and the user has not answered within 45 s.

boolean

Example

{
  "error": "bad client credentials"
}

403

Your app is disabled, or no longer reaches this user: the account was disabled, or the user left the team of your private app.

application/json

object

error

required

string

consentPending

Present and true when the approval window is open and the user has not answered within 45 s.

boolean

Examples

{
  "error": "client disabled"
}

{
  "error": "account disabled"
}

{
  "error": "app is private"
}

404

Not a user connected to this app.

application/json

object

error

required

string

consentPending

Present and true when the approval window is open and the user has not answered within 45 s.

boolean

Example

{
  "error": "unknown user_ref"
}