---
title: "Search presentations"
method: GET
path: "/api/v1/presentations/search-by-title"
tags: ["Presentations"]
---

# Search presentations

`GET /api/v1/presentations/search-by-title`

## Request

- Base URL: `https://api.pitch.com`
- URL: `https://api.pitch.com/api/v1/presentations/search-by-title`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Search presentations by title, across everything the caller can access in the workspace.

## Query parameters

- `query` string, required
- `limit` integer

## Response `200`

- object
  - `data` object[], required
    - `presentation_id` string, uuid, required: UUID of the presentation.
    - `title` string, required: The presentation's title.
    - `breadcrumb` union[], required: Where the presentation lives: the teamspace or private space that holds it first, then each folder on the way down, ending with its immediate parent folder. A presentation at the top level of its space has a single element. Folders are omitted when the caller may read the presentation but not the folders around it.
      - union
        - object: The teamspace the content lives in. Pass the id as move-content's target_teamspace_id to move content here.
          - `name` string, nullable, required: The teamspace's name, null when it is hidden from the caller.
          - `teamspace_id` string, uuid, required
        - object: The private space the content lives in.
          - `name` string, required
          - `private_space` unknown, required
          - `owner_id` string, uuid: Set when the private space is not the caller's own.
        - object: A folder on the way from the space down to the content. Pass the id as move-content's target_folder_id to move content here.
          - `name` string, required
          - `folder_id` string, uuid, required

## Other responses

- `400`

---

[API](https://skmtc.dev/pitch/apis/pitch-api.md) - [All operations](https://skmtc.dev/pitch/apis/pitch-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pitch/apis/pitch-api/revisions/68c834acb4bb?raw)