---
title: "Get a post's content group"
method: GET
path: "/v1/posts/{postId}/bucket"
tags: ["buckets"]
---

# Get a post's content group

`GET /v1/posts/{postId}/bucket`

## Request

- Base URL: `https://public.api.paragraph.com/api`
- URL: `https://public.api.paragraph.com/api/v1/posts/{postId}/bucket`
- Auth: HTTP bearer

Find the group a post belongs to, without creating one.

Answers `null` when nothing has been made from the post yet. To attach something, call `POST /v1/posts/{postId}/bucket` instead, which creates the group on first use.

A post you've reopened for editing resolves to the live post's group, so a draft id and its published id give the same answer.

## Path parameters

- `postId` string, required

## Response `200`

Content group retrieved successfully

- object
  - `bucketId` string, nullable, required: The bucket this post is grouped in, or null when nothing has been made from it yet

## Other responses

- `401`: Invalid or missing API key
- `404`: Post not found in your publication
- `500`: Internal server error

## Changes

- **2026-09-01** `2d43a4d31af2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/changes/v1/posts/:postId/bucket/get.md)

---

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