Skip to content

List agents waiting for approval

List your pending agent sign-in requests, newest first. The response gives the agent name, device name, expiration and request ID used for approval or denial.

Returns

#
dataobjectAlways present
Connection requests awaiting your decision, newest first.
Show 1 attributeHide attributes
requestsobject[] | nullAlways present
Pending requests you can approve or deny.
Show 1 attributeHide attributes
itemsobject
A connection request from a program that redeemed a code.
Show 5 attributesHide attributes
agentstringAlways present
Agent name supplied by the requesting program.
expires_atstring (date-time)Always present
When this approval request expires.
idstringAlways present
Request ID for approval or denial.
machinestringAlways present
Machine name supplied by the requesting program.
requested_atstring (date-time)Always present
When the code was redeemed.

Errors

#
CodeStatusWhat happened
invalid400An input is missing or invalid.
unauthenticated401The credential is missing, invalid, expired or revoked.
denied403The caller lacks permission for this action.
not_found404The resource is absent or inaccessible to this caller.
conflict409The request conflicts with the current resource state or an earlier request.
over_capacity409The request exceeds a resource or credential allowance.
access_list_full409The change would exceed the access-list allowance.
rate_limited429The caller's request rate exceeds its limit.
busy429Too much work is in progress to accept this request.
unknown503The outcome is unconfirmed; a change may have happened.
unavailable503The service or requested feature is unavailable.

Notes

#
  • API key permission: connect-code view.