---
title: "Post Collections List Route"
method: GET
path: "/post_collections"
tags: ["post_collections"]
---

# Post Collections List Route

`GET /post_collections`

## Request

- Base URL: `https://api.robopost.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.robopost.app/post_collections`
- Auth: HTTP bearer

## Query parameters

- `search_text` string
- `is_recur` boolean
- `is_shared_with_my_team` boolean
- `skip` integer
- `limit` integer
- `sort_by_field` string
- `sort_order` string

## Response `200`

Successful Response

- PostCollectionRead[]
  - `_id` string
  - `name` string, required
  - `color` string, required
  - `automation_id` string
  - `next_scheduled_post_id` string
  - `posting_strategy` 'RANDOM' | 'ORDERED_LOOP' | 'ORDERED_WAIT': An enumeration.
  - `delete_post_after_posting` boolean
  - `is_recur` boolean
  - `timezone` string
  - `posts_count` integer
  - `recur_rephrase_text_with_ai` boolean
  - `recur_rephrase_text_with_ai_tone` 'POLITE' | 'WITTY' | 'ENTHUSIASTIC' | 'INFORMATIONAL' | 'FUNNY' | 'FORMAL' | 'INFORMAL' | 'HUMOROUS' | 'SERIOUS' | 'OPTIMISTIC' | 'MOTIVATING' | 'RESPECTFUL' | 'ASSERTIVE' | 'CONVERSATIONAL' | 'CASUAL' | 'PROFESSIONAL' | 'SMART' | 'NOSTALGIC' | 'FRIENDLY': An enumeration.
  - `recur_dt` string, date-time
  - `recur_interval` 'DAILY_SPECIFIC_TIME_SLOTS' | 'WEEKLY_SPECIFIC_TIME_SLOTS' | 'EVERY_3_HOURS' | 'EVERY_6_HOURS' | 'BI_DAILY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY': An enumeration.
  - `recur_interval_time_slots` string[]
  - `recur_interval_weekly_time_slots` string[]
  - `recur_until_dt` string, date-time
  - `recur_until_dt_enabled` boolean
  - `user_id` string
  - `team_id` string
  - `share_to_team_ids` string[]
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `is_deleted` boolean
  - `next_scheduled_post` object

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/robopost/apis/robopost-api.md) · [All operations](https://skmtc.dev/robopost/apis/robopost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/robopost/apis/robopost-api/revisions/46b1cafa8808?raw)