Skip to content

Approve an agent

Approve an agent's sign-in from an authenticated browser session. The agent can then collect a 90-day API key carrying your authority in the code's organization.

Parameters

#
requeststringRequired
The pending agent request ID returned by connect-code view.

Returns

#
dataobjectAlways present
A decision on a connection request.
Show 3 attributesHide attributes
idstringAlways present
Connection request's ID.
key_idstring
API key ID reserved by approval, usable for revocation. The program receives its secret on its next request. May be omitted.
statestringAlways present
Request's state after approval or denial.

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.
payment_required402Payment or credit is required.
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

#
  • Requires a signed-in website session.
  • A key limited to a command list cannot run this command.