The partner's agents and who they are here

GET 
/app_installs/:id/agents

The agents the app reported (PUT /app/agents) or named in its events, the first 1,000 by name, each with the member it matches. how is as stored: email (matched by address), manual (an admin chose — user: null with former_user: null is "No KudosCRM user", and it sticks), none. user is shown only while that member is active; once they are not, user is null and former_user names them, so a departed member's match — email or manual — never reads like "No KudosCRM user". integrations.read. Throttle: app_installs/read/minute, 300 a minute.

A signed-in session or the person's own personal access token; an app's OAuth token is refused (403 resource_not_grantable).

Request

Responses

200

The agents, the first 1,000 by name.

401

No session or token, or one that is no longer valid. A request that presented a token gets WWW-Authenticate: Bearer realm="KudosCRM", error="invalid_token" (refresh it); one with no credentials and no session cookie gets the bare challenge.

Response Headers

WWW-Authenticate
Example: Bearer realm="KudosCRM", error="invalid_token"

403

Not allowed: the permission this route needs is missing, the Integrations module is off (code: module_disabled, meta.module_key, meta.blocked_at_layer), or the caller is an app's own OAuth token (code: resource_not_grantable).

404

Not found in this workspace — or not something the caller may know exists.