Retrieve All Posts or by Type

get

https://{hostname}/api/talk/content/v1/posts

This operation returns all posts in the system or a subset of posts according to the specified filter criteria. The response may be paginated using index and count.

Authorization and Permissions

An OpenAm token is required to make a post.
The user must have content creation permission, which is granted by a Talk administrator.

Query Params

type

string

enum

The type of post to retrieve. Valid values include user-post, announcement, event, poll, survey, calendar, and ideabox. If no value is specified, all posts are returned.

Allowed:

count

number

The count of a paginated response, which specifies the number of posts to return per page. If not specified, a default of 100 posts is returned. The count cannot exceed 100.

page-token

string

The page-token is a string that represents the continuation token for a token-based pagination response and is used to retrieve a particular page of results. If not specified, the first page of results is returned.

Headers

Authorization

string

required

An OpenAm token for the user.

x-correlation-id

string

A UUID value to track the request, used for debugging and tracing.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

application/json

application/problem+json

200Successfully retrieved posts.

400The HTTP status code 400 Bad Request error, thrown when required parameters are not passed.

401The HTTP status code 401 Unauthorized error, thrown when the user is not authorized to access the resource.

403The HTTP status code 403 Forbidden error, thrown when the user is not authorized to access the resource.

405The HTTP status code 405 Method Not Allowed error, thrown when you attempt to call a URI with an unsupported HTTP method.

406The HTTP status code 406 Not Acceptable Content error, thrown when you send a request with accept header other than application/json.

429The HTTP status code 429 Too Many Requests error, thrown when the user exceeds the allowed rate limit for the API.

500The HTTP status code 500 Internal Server error, thrown when the server is not able to process the request.