keys.connections

List every outside agent connected to the shop through OAuth (owner only): which worker connected it, the client name, whether it reaches only this shop or all of that worker's shops, scopes, when connected, last used and revoked. Any worker can connect an agent that acts as themselves; the owner sees all of them.

When to use it

The owner makes a key for each agent they use, with a name they will recognize. The key is shown once and never again, so save it when it is made.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

Example

GET https://doingwork.work/v1/keys/connections?shop_id=00000000-0000-4000-8000-000000000000

Output

{
  "connections": [
    {
      "connection_id": "00000000-0000-4000-8000-000000000000",
      "client": "...",
      "worker_id": "00000000-0000-4000-8000-000000000000",
      "worker": "...",
      "worker_email": "...",
      "role": "...",
      "shops": "this_shop",
      "scopes": "...",
      "connected_at": "...",
      "last_used_at": "...",
      "revoked_at": "..."
    }
  ]
}

Errors