FeedBoss Documentation

Infographic API

Base URL: https://server.feedboss.ai/api/v1/infographic

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

Endpoints

1. Generate Infographic

Generates a new infographic based on a prompt and optional reference materials.

Endpoint: /generate/:workspaceId
Method: POST
Headers: Content-Type: multipart/form-data (if uploading file) or application/json

Path Parameters:

Parameter	Type	Required	Description
`workspaceId`	string	Yes	The ID of the workspace.

Body (FormData or JSON):

Parameter	Type	Required	Description
`prompt`	string	Yes	Description of the infographic to generate.
`postContent`	string	No	Context or content to be included/visualized.
`referenceImageUrl`	string	No	URL of a reference image to use as a template.
`referenceImage`	file	No	Image file to use as a reference template.
`size`	string	No	Dimensions for the image (e.g., “1024x1792”, defaults to “auto”).

Success Response (201 Created):

{
  "success": true,
  "data": {
    "infographicId": "65b...",
    "name": "Infographic 1706...",
    "prompt": "Create a checklist...",
    "postContent": "...",
    "referenceImageUrl": "http://...",
    "generatedImageUrl": "http://...",
    "status": "generated",
    "createdAt": "2026-01-28T..."
  }
}

Error Response:

400 Bad Request: Missing prompt, quota exceeded, or validation error.
402 Payment Required: Trial expired.
500 Internal Server Error: Generation failure.

2. Regenerate Infographic

Regenerates an existing infographic with a modified prompt. Updates the existing record.

Endpoint: /regenerate/:workspaceId/:infographicId
Method: POST

Path Parameters:

Parameter	Type	Required	Description
`workspaceId`	string	Yes	The ID of the workspace.
`infographicId`	string	Yes	The ID of the infographic to regenerate.

Body (JSON):

Parameter	Type	Required	Description
`prompt`	string	Yes	New instructions for regeneration (how to modify the image).

Success Response (201 Created):

{
  "success": true,
  "data": {
    "infographicId": "65b...",
    "name": "Infographic 1706...",
    "prompt": "Original prompt...",
    "regenerationPrompt": "Make the text blue",
    "generatedImageUrl": "http://.../new_image.png",
    "status": "generated",
    "isRegeneration": true,
    "updatedAt": "2026-01-28T..."
  }
}

Error Response:

400 Bad Request: Missing prompt.
402 Payment Required: Trial expired.
500 Internal Server Error: Regeneration failure.

3. Get All Infographics

Retrieves all infographics for a specific workspace.

Endpoint: /:workspaceId
Method: GET

Path Parameters:

Parameter	Type	Required	Description
`workspaceId`	string	Yes	The ID of the workspace.

Success Response (200 OK):

{
  "success": true,
  "data": [
    {
      "infographicId": "65b...",
      "name": "Infographic 1706...",
      "generatedImageUrl": "http://...",
      "status": "generated",
      "createdAt": "..."
    },
    // ... more items
  ]
}

4. Get Single Infographic

Retrieves details of a specific infographic.

Endpoint: /:workspaceId/:infographicId
Method: GET

Path Parameters:

Parameter	Type	Required	Description
`workspaceId`	string	Yes	The ID of the workspace.
`infographicId`	string	Yes	The ID of the infographic.

Success Response (200 OK):

{
  "success": true,
  "data": {
    "infographicId": "65b...",
    "name": "Infographic 1706...",
    "prompt": "...",
    "generatedImageUrl": "http://...",
    "status": "generated",
    "dimensions": { "width": "auto", "height": "auto" },
    "createdAt": "..."
  }
}

Error Response:

404 Not Found: Infographic does not exist.

5. Delete Infographic

Deletes an infographic and its associated images from storage.

Endpoint: /:workspaceId/:infographicId
Method: DELETE

Path Parameters:

Parameter	Type	Required	Description
`workspaceId`	string	Yes	The ID of the workspace.
`infographicId`	string	Yes	The ID of the infographic.

Success Response (200 OK):

{
  "success": true,
  "message": "Infographic deleted successfully"
}

Error Response:

400 Bad Request: Failed to delete.