---
title: "Describe Connector Authorization"
method: POST
path: "/api/v1/connector/authorization/describe"
tags: ["connector"]
---

# Describe Connector Authorization

`POST /api/v1/connector/authorization/describe`

## Request body

- ConnectorAuthorizationRequest
  - `request` string, required

## Response `200`

Successful Response

- ConnectorAuthorizationDescription — What the consent page shows before the user approves a connection.
  - `client_name` string, nullable, required
  - `client_uri` string, nullable, required
  - `verified_client_host` string, nullable, required — Host vouching for the client (metadata-document clients); null when the client named itself.
  - `redirect_host` string, required
  - `scopes` string[], required
  - `account_email` string, nullable, required
  - `allowed` boolean, required
  - `refusal_message` string, nullable, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-25** `bb508e935174` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/connector/authorization/describe/post.md)

---

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