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) orapplication/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.