# Posts

A Post represents a message written by participants in a project that appears in the project. Replies are only
included if they are directly related to a post. Replies to events, such as Change Orders or Story Created
Events, are not included.

## Fetching a list of Posts

 - [GET /posts](https://developer.kantata.com/kantata/specification/posts/get-posts.md): This endpoint returns structured Post objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the posts top-level JSON key.
Please see our Response Format section for more information.

## Creating a new Post

 - [POST /posts](https://developer.kantata.com/kantata/specification/posts/create-post.md): Posts to the Activity Feed of a workspace (project).

Bulk Create

This endpoint supports bulk creating up to 100 objects. In the request body, set the top-level key to its plural form and place the objects in an array. Example:


{
  "posts": [
    {
      "workspace_id": 123,
      "message": "Post"
    },
    {
      "workspace_id": 456,
      "message": "Post"
    }
  ]
}



This endpoint returns structured Post objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the posts top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single Post

 - [GET /posts/{id}](https://developer.kantata.com/kantata/specification/posts/get-post.md): By default, you won't receive Posts from archived workspaces (and will receive a 404 status
on the "show" route) unless you provide the from_archived_workspaces:true filter.


This endpoint returns structured Post objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the posts top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing Post

 - [PUT /posts/{id}](https://developer.kantata.com/kantata/specification/posts/update-post.md): This endpoint returns structured Post objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the posts top-level JSON key.
Please see our Response Format section for more information.

## Deleting an existing Post

 - [DELETE /posts/{id}](https://developer.kantata.com/kantata/specification/posts/delete-post.md): The response will contain no content and an HTTP 204 status code if the request was
successful, or a standard Kantata OX error message explaining why the object could not be deleted.