---
title: "List the apps you have connected"
method: GET
path: "/self/oauth-grants"
tags: ["OAuth Consent"]
---

# List the apps you have connected

`GET /self/oauth-grants`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/self/oauth-grants`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

## Response `200`

Connected apps

- ConnectedAppsList
  - `result` ConnectedApp[], required
    - `id` integer, required
    - `client_name` string, nullable
    - `client_logo_url` string, nullable
    - `workspace_id` integer, required
    - `workspace_name` string, nullable
    - `project_id` integer, nullable: null = "All projects" in the workspace
    - `project_name` string, nullable
    - `projects` ConsentProject[], nullable: Every project the app is pinned to; null = "All projects"
      - `id` integer, required
      - `name` string, required
    - `read_only` boolean: True when the app may read but not change data
    - `created_at` string, date-time, required

## Other responses

- `401`: Authorization error

---

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