---
title: "List team decks"
method: GET
path: "/v1/team/decks"
tags: ["Team"]
---

# List team decks

`GET /v1/team/decks`

## Request

- Base URL: `https://api.slides.com`
- URL: `https://api.slides.com/v1/team/decks`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://slides.com/oauth/authorize`, token URL `https://slides.com/oauth/token`, scopes: `read`)

Returns team-visible and public decks from the authenticated user’s team.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Deck summaries are returned in data; meta contains page, per_page, and total. Every summary includes visibility and deck owner identity; MCP results include only the owner’s display name.

- ApiResponse
  - `data` unknown, required
  - `meta` object

## Other responses

- `401`: A valid API key or OAuth access token is required.
- `403`: The credential or account cannot perform this operation.
- `422`: The request parameters or body are invalid.
- `429`: The request rate limit was exceeded.

---

[API](https://skmtc.dev/slides/apis/slides-rest-api.md) · [All operations](https://skmtc.dev/slides/apis/slides-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slides/apis/slides-rest-api/revisions/7d5a371a6715?raw)