# Post Publishing & Schedule

The **Posts Endpoints** provide full CRUD (Create, Read, Update, Delete) functionality for managing social media posts. These endpoints allow users to create new posts, retrieve existing ones, update their content, and delete posts when no longer needed.

Each operation requires a specific permission tied to the API token to ensure secure and controlled access:

* **Create Social Post** (`POST /posts`)\
  Allows creating and scheduling new social media posts.\
  ⚠️ **Required Permission:** `social-create-post`
* **View Social Post** (`GET /posts/{id}`)\
  Allows viewing the details of a specific social media post.\
  ⚠️ **Required Permission:** `social-view-post`
* **Read Social Posts** (`GET /posts`)\
  Allows listing and retrieving all social media posts.\
  ⚠️ **Required Permission:** `social-read-posts`
* **Update Social Post** (`PUT /posts/{id}`)\
  Allows updating the content of an existing social media post.\
  ⚠️ **Required Permission:** `social-create-post` *(same permission used for create/update)*
* **Delete Social Post** (`DELETE /posts/{id}`)\
  Allows deleting social media posts.\
  ⚠️ **Required Permission:** `social-delete-post`

By structuring permissions this way, developers can fine-tune access control and ensure each API client only has the level of post management access they require.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.marketingblocks.ai/agentic-ai-docs/api-reference/social-growth-engine/post-publishing-and-schedule.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.