FeedBoss Documentation

Get Recent Posts

Retrieves a list of recent posts for a specific workspace, including drafts, scheduled posts, and published posts from the last 90 days. It also includes future scheduled posts.

URL: GET https://server.feedboss.ai/api/v1/ai-conversation/recent-posts/:workspaceId

Authentication

All endpoints require authentication. You can authenticate using a Service API Key.

Service API Key

Add your Service API Key to the x-api-key header.

x-api-key: fb_live_xxxxxxxxxxxxxxxxxxxxxxxx

Request Parameters

URL Parameters

ParameterTypeRequiredDescription
workspaceIdstringYesThe unique identifier of the workspace.

Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token for authentication.

Response Structure

Success Response (200 OK)

{
  "success": true,
  "data": {
    "posts": [
      {
        "id": "60d5ecb8b5c9c62b3c7c4b5a",
        "conversationId": "60d5ecb8b5c9c62b3c7c4b5b",
        "conversationTitle": "Project Launch Announcement",
        "postContent": "Excited to announce our new project...",
        "postType": "text",
        "status": "draft",
        "createdAt": "2023-10-27T10:00:00.000Z",
        "scheduledAt": null,
        "linkedinAccount": {
          "name": "John Doe",
          "email": "john.doe@example.com"
        },
        "metrics": {
          "likes": 0,
          "comments": 0
        },
        "postUrl": null,
        "carousel": null,
        "infographic": null,
        "generatedHeadshot": null,
        "customImage": null
      }
    ],
    "total": 1,
    "dateRange": {
      "from": "2023-07-29T10:00:00.000Z",
      "to": "2023-10-27T10:00:00.000Z"
    }
  }
}

Access Denied (403 Forbidden)

Occurs if the user is not a member of the workspace.

{
  "success": false,
  "message": "Access denied"
}

Server Error (500 Internal Server Error)

{
  "success": false,
  "message": "Failed to retrieve recent posts"
}

Detailed Field Descriptions

Post Object

  • id: Unique identifier for the post.
  • conversationId: ID of the AI conversation that generated this post.
  • conversationTitle: Title of the conversation or a snippet of the post content if no title exists.
  • postContent: The text content of the LinkedIn post.
  • postType: Type of post (e.g., ‘text’, ‘carousel’, ‘image’).
  • status: Current status of the post (draft, scheduled, published).
  • createdAt: Timestamp when the post was created.