Agency Partners
List a Client's Posts
Lists one client's posts, like List Posts with X-Workspace-Id.
https://app.tryredrover.com/api/public/v1/clients/{client}/postsposts:readNeeds a partner key; any other key or a connected AI app gets 403.
Headers
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.
Path Parameters
clientstringRequiredThe client's workspace ID, or your own reference for it. A UUID is tried as an ID first
Query Parameters
limitintegerHow many results to return, 1 to 100 (default 25)
1 to 100 · default 25
offsetintegerHow many results to skip (default 0)
default 0
statusstringOnly return content with this status
one of draft, pending_approval, scheduled, posted, failed, cancelled
Response
200 A page of posts.
dataobject[]RequiredShow 15 Child FieldsHide Child Fields
idstringRequiredContent ID. Content waiting for your approval has a UUID; scheduled content has a number
typestringRequiredpost or comment
one of post, comment
statusstringRequiredWhere it stands
one of draft, pending_approval, approved, scheduled, posted, failed, cancelled
titlestringRequiredPost title. Null for comments
nullable
bodystringRequiredThe text
nullable
subredditstringRequiredSubreddit, without r/
nullable
flairstringRequiredPost flair. Posts only
nullable
threadUrlstringRequiredComments only: the thread the comment replies in
nullable
scheduledForstringRequiredWhen it is due to go live
nullable
postedAtstringRequiredWhen it went live
nullable
urlstringRequiredThe live link once posted
nullable
upvotesnumberRequiredUpvotes once posted
nullable
commentCountnumberRequiredReplies once posted
nullable
failureReasonstringRequiredWhy it failed or was removed, when it did
nullable
canChangebooleanRequiredWhether you can still edit, reschedule or cancel it
paginationobjectRequiredShow 3 Child FieldsHide Child Fields
limitintegerRequiredPage size used for this response
offsetintegerRequiredHow many results were skipped
hasMorebooleanRequiredTrue when more results follow at a higher offset
Errors
Every error uses the error envelope.
404No client with this ID or reference in your agency401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/clients/crm-1042/posts?status=scheduled" \
-H "Authorization: Bearer $REDROVER_API_KEY"{
"data": [
{
"id": "48213",
"type": "post",
"status": "scheduled",
"title": "What we learned shipping a weekly changelog for a year",
"body": "We started writing a public changelog every Friday. Here is what changed for us...",
"subreddit": "startups",
"flair": "Lessons Learned",
"threadUrl": null,
"scheduledFor": "2026-12-01T15:00:00Z",
"postedAt": null,
"url": null,
"upvotes": null,
"commentCount": null,
"failureReason": null,
"canChange": true
}
],
"pagination": {
"limit": 25,
"offset": 0,
"hasMore": false
}
}