---
title: "Get Consent Options"
method: GET
path: "/api/integrations/instances/{registration_id}/oauth/consent"
tags: ["mcp-oauth"]
---

# Get Consent Options

`GET /api/integrations/instances/{registration_id}/oauth/consent`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/integrations/instances/{registration_id}/oauth/consent`
- Auth: none declared

The permissions a person may choose when connecting (TOS-6946).

Same authority as initiate: whoever may connect this account may read what
connecting it would ask for. ``new=true`` answers for ANOTHER connection
to the same connector (the Add connection flow, before the new account
exists): the connector's own release, blank, nothing current.

## Path parameters

- `registration_id` string, uuid, required

## Query parameters

- `new` boolean

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- ConsentOptionsOut: What the "Choose what it can do" step renders for one connection (TOS-6946). ``declared`` false means the connector declares no permissions and the page keeps today's connect flow. ``permissions`` lists only what can be asked for (what today's profile scopes already grant). ``current`` is what a reconnect keeps when the person changes nothing; ``None`` for a new connection, which starts blank.
  - `declared` boolean, required
  - `is_new` boolean, required
  - `provider` string, nullable
  - `purpose` string, nullable
  - `permissions` ConsentPermissionOut[]
    - `key` string, required
    - `label` string, required
    - `description` string, required
    - `implies` string[], required
    - `risk` string, nullable, required
    - `provider_scopes` string[], required
  - `current` string[], nullable
  - `provider_scope_notes` object
  - `try_it` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)