> ## Documentation Index
> Fetch the complete documentation index at: https://www.posted.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Read an MCP consent request

> Reads the client and requested authorization for the signed-in human's approval screen.

A signed-in human session is required. API keys and MCP bearer credentials cannot replace that session.

Reads the client and requested authorization for the signed-in human's approval screen.

[Request conventions](/api-reference/overview) · [API keys](/api-keys) · [MCP connections](/mcp-connections)


## OpenAPI

````yaml api-reference/openapi.json GET /api/oauth/consent/{id}
openapi: 3.1.0
info:
  title: Posted HTTP API
  version: 0.2.0
  description: >-
    All registered application, account, OAuth, MCP transport and health
    endpoints. Publishing and draft request schemas come from the shared runtime
    validators. Replace the example server with your installation. Documentation
    uses simple request examples and does not execute live publishing requests.
servers:
  - url: https://posted-api.example.com
security: []
paths:
  /api/oauth/consent/{id}:
    get:
      tags:
        - OAuth and MCP transport
      summary: Read an MCP consent request
      description: >-
        Reads the client and requested authorization for the signed-in human's
        approval screen.


        A signed-in human session is required. API keys and MCP bearer
        credentials cannot replace that session.
      operationId: get_api_oauth_consent_by_id
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            The id from the corresponding list, record or authorization
            response.
      responses:
        '200':
          description: >-
            Successful response. Examples are illustrative; field values vary by
            record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  clientName:
                    type: string
                  clientId:
                    type: string
                  clientTrust:
                    type: string
                  redirectUri:
                    type: string
                  scope:
                    type: string
                  expiresIn:
                    type: integer
                  user:
                    type: object
                    properties:
                      name:
                        type: string
                      role:
                        type: string
                    additionalProperties: true
                  availableAccessLevels:
                    type: array
                    items:
                      type: string
                  canApprove:
                    type: boolean
                additionalProperties: true
              example:
                clientName: Studio assistant
                clientId: example-client-id
                clientTrust: unverified
                redirectUri: https://client.example.test/callback
                scope: read
                expiresIn: 2592000
                user:
                  name: Alex Morgan
                  role: member
                availableAccessLevels:
                  - read
                  - write
                canApprove: true
        default:
          description: >-
            OAuth failure with error and error_description. Consent/session
            authority may also return the standard Posted error envelope.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  error_description:
                    type: string
      security:
        - sessionCookie: []
components:
  securitySchemes:
    sessionCookie:
      type: apiKey
      in: cookie
      name: posted_session
      description: >-
        Signed-in human browser session; mutation requests also need the exact
        UI Origin

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.