Agents · describeOAuthRequest

Look up a connector request

GET /v1/oauth/requests/{id}

For the app's /connect page, where an MCP client (claude.ai, ChatGPT, Cursor…) sends the human after GET /oauth/authorize: the name the client registered, the host its redirect goes to (local when it's this computer) and when the request expires (10 minutes). 404 for an unknown or expired request, 409 when it was already approved or cancelled.

Who may call it: any signed-in human
Server: https://api.logu.dev

Parameters#

Name	In	Type	Required	Description
`id`	path	`string`	required	The OAuth request's id (`oar_…`), from the `/connect?request=` link. · e.g. `oar_Tq9mZ2xK7pW4vR8nB3cY6dF1gH5jL0sA`

Example#

curl -s "https://api.logu.dev/v1/oauth/requests/oar_Tq9mZ2xK7pW4vR8nB3cY6dF1gH5jL0sA" \
  -H "Authorization: Bearer $LOGU_SESSION_TOKEN"

Responses#

200

The pending request.

{
  "id": "oar_Tq9mZ2xK7pW4vR8nB3cY6dF1gH5jL0sA",
  "clientName": "Claude",
  "clientUri": "https://claude.ai",
  "redirectHost": "claude.ai",
  "local": false,
  "expiresAt": "2026-10-01T09:10:00.000Z"
}

Response fields

Field	Type	Required	Notes
`id`	`string`	required
`clientName`	`string`	required
`clientUri`	`string \| null`	required
`redirectHost`	`string`	required
`local`	`boolean`	required
`expiresAt`	`string`	required	date-time

Errors#

Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.

Status	Code	Meaning
401	`unauthorized`	No credentials, or the API key or session is invalid or revoked.
403	`forbidden`	The caller is authenticated but may not do this (wrong role, or an API key on a human-only endpoint).
404	`not_found`	No such route, or the resource doesn't exist in your workspace.
409	`conflict`	The resource isn't in a state that allows this: an ask that is no longer waiting (`ask` has its current state), an invitation no longer pending, the last Owner.
500	`internal_error`	Something went wrong on Logu's side.