Skip to main content

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:

ParameterTypeRequiredDescription
workspaceIdstringYesThe ID of the workspace.

Body (FormData or JSON):

ParameterTypeRequiredDescription
promptstringYesDescription of the infographic to generate.
postContentstringNoContext or content to be included/visualized.
referenceImageUrlstringNoURL of a reference image to use as a template.
referenceImagefileNoImage file to use as a reference template.
sizestringNoDimensions 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:

ParameterTypeRequiredDescription
workspaceIdstringYesThe ID of the workspace.
infographicIdstringYesThe ID of the infographic to regenerate.

Body (JSON):

ParameterTypeRequiredDescription
promptstringYesNew 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:

ParameterTypeRequiredDescription
workspaceIdstringYesThe 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:

ParameterTypeRequiredDescription
workspaceIdstringYesThe ID of the workspace.
infographicIdstringYesThe 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:

ParameterTypeRequiredDescription
workspaceIdstringYesThe ID of the workspace.
infographicIdstringYesThe ID of the infographic.

Success Response (200 OK):

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

Error Response:

  • 400 Bad Request: Failed to delete.