---
title: "Initiate admin connector consent"
method: GET
path: "/auth/connectors/{connector_id}/consent/admin"
tags: ["AuthConnector"]
---

# Initiate admin connector consent

`GET /auth/connectors/{connector_id}/consent/admin`

## Request

- Base URL: `https://api.your-domain.com`
- URL: `https://api.your-domain.com/auth/connectors/{connector_id}/consent/admin`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/docs/auth/connectors/:connector_id/consent/admin/get.ts> (a function with typed inputs; its response is checked against the schema)

Start the admin consent flow for connectors that require organization-wide admin consent.

## Path parameters

- `connector_id` integer, required: ID of the connector to consent to.

## Query parameters

- `tenant_id` integer
- `cookie_name` string, nullable

## Response `200`

Successful Response

- ConnectorConsentOut
  - `consent_url` string, required: URL to redirect the user to for granting consent.
  - `connector` ConnectorOut, required
    - `id` integer, required: Unique identifier of the connector.
    - `name` string, required: Human-readable connector name.
    - `provider` string, required: OAuth provider key backing the connector.
    - `caps` string[], required: Capabilities the connector requests.
    - `scopes` string[], required: OAuth scopes requested from the provider.

## Other responses

- `401`: Missing or invalid authentication.
- `403`: Administrator privileges required.
- `404`: No connector or OAuth client exists for the given id.
- `422`: Validation Error
- `503`: The OAuth provider has no admin consent URL or is misconfigured.

---

[API](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api.md) - [All operations](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/revisions/b53e89b98c2b?raw)