---
title: "Read an AI app's request to connect"
method: GET
path: "/ai-apps/requests/{request_id}/"
tags: ["ai_apps"]
---

# Read an AI app's request to connect

`GET /ai-apps/requests/{request_id}/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/ai-apps/requests/{request_id}/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

What the consent page shows: the app asking to connect, where the person returns afterwards, and the workspaces they may connect it to. Only the signed-in person may read it.

## Path parameters

- `request_id` string, required

## Response `200`

Successful Response

- AiAppRequestReadSchema: An AI app asking to connect, as the consent page shows it.
  - `app_name` string, required: What to call the app.
  - `brand` 'claude' | 'chatgpt' | 'other', required: Whose mark the dashboard shows beside a connected app.
  - `is_local` boolean, required: Whether the app runs on this computer.
  - `recognised` boolean, required: Whether the app is recognised by a host its maker controls; an unrecognised app is shown as unverified.
  - `redirect_host` string, required: Where the person returns after answering.
  - `workspaces` AiAppWorkspaceChoiceSchema[], required
    - `can_write` boolean, required: Whether an AI app may make changes in this workspace (a paid plan).
    - `name` string, required
    - `workspace_id` string, required

## Other responses

- `401`: Unauthorized
- `403`: Asked through an AI, not a person.
- `404`: The request expired or was answered.
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Workspaces could not be read.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)