# List Confluence items

URL: /en/docs/api/v1/integrations/confluence/post
Last Updated: 2026-07-30T21:15:30.130Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/integrations/confluence

**List Confluence items**

Lists Confluence sites, spaces, or page children depending on request context (`siteId`, `parentType`, `parentId`). Emits eventName `integrations.confluence.fetch_items` and failureEventName `integrations.confluence.fetch_items_failed`.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`):

- `providerConfigKey` (string): Optional provider configuration key
- `connectionId` (string): Optional Confluence connection ID override
- `siteId` (string): Confluence site (cloud) ID
- `parentType` (enum: site | space | page)
- `parentId` (string): Space ID or parent page ID
- `pageToken` (string): Cursor for the next page
- `search` (string): Case-insensitive title filter

**Responses:**

- `200` - Confluence items loaded
  - `success` (enum: true, required)
  - `data` (object, required)
    - `items` (array of ConfluencePickerItem (object), required)
      - `id` (string, required)
      - `type` (enum: site | space | page, required)
      - `title` (string, required)
      - `subtitle` (string)
      - `siteId` (string)
      - `parentId` (string)
      - `url` (string)
      - `hasChildren` (boolean)
      - `lastEditedTime` (string)
    - `nextPageToken` (string)
- `400` - Bad request
  - `error` (string, required)
  - `code` (string)
  - `data` (object)
- `401` - Unauthorized
- `403` - Forbidden - Admin or Content Manager role required
  - `error` (string, required)
  - `code` (string)
  - `data` (object)
- `404` - Confluence integration not found
  - `error` (string, required)
  - `code` (string)
  - `data` (object)
- `500` - Internal server error

