GenuineAIGenuineAI
For usersFor developers
  • Overview
  • Guides
  • How-to
  • API reference
Documentation
  • Quickstart
  • Authentication
  • Errors
  • Rate limits
  • API reference
Platform
  • Platform overview
  • Solutions
  • Pricing
  • Sign in
Company
  • Status
  • Trust Center
  • Contact
  • Terms of Service
  • Privacy Policy

© 2026 GenuineAI Ventures LLC

support@genuinehq.com
Overview
Core
Media library
AI
Documents
Knowledge
Creative
    Designs
    Design categories
    Studio
    Infographics
      List infographicsgetDelete an infographicdeleteRename an infographicpatchGet who has accessgetSet who has accessputDownload the HTML sourcegetDownload the imagegetRefresh the datapostSet the refresh scheduleputRender a PNGpostConvert to a designpostList versionsget
    Presentations
    Presentation templates
Website & content
Automation
Customer channels
Administration
Schemas
GenuineAI API
GenuineAI API

Infographics

Generated data graphics: an HTML source and the image rendered from it.


List infographics

GET
https://api.genuineai.app/api/v1
/infographics

Returns the newest revision of each infographic, with how many revisions it has. Earlier ones are read through the versions endpoint.

List infographics › query Parameters

file_name
​string · maxLength: 500
limit
​integer · min: 1 · max: 1000
offset
​integer · min: 0
search
​string · maxLength: 500
sort
​string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$

List infographics › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List infographics › Responses

Success

​Infographic[]
A generated data graphic: the image, and the HTML it was rendered from.
Infographic
file_id
​string · uuid
file_name
​string
file_type
​string
file_size
​integer
file_created
​string · date-time
file_updated
​string · date-time
file_added_by
​string
file_repo
​string
file_hash
​string
file_metadata
​object
file_replicas
​string
file_provider_id
​string · uuid
file_bucket
​string
file_folder
​string
file_pref
​object
version_count
​integer
GET/infographics
curl https://api.genuineai.app/api/v1/infographics \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
[ { "file_id": "00000000-0000-0000-0000-000000000000", "file_name": "file_name", "file_type": "file_type", "file_size": 0, "file_created": "2024-08-25T15:00:00Z", "file_updated": "2024-08-25T15:00:00Z", "file_added_by": "file_added_by", "file_repo": "file_repo", "file_hash": "file_hash", "file_metadata": {}, "file_replicas": "file_replicas", "file_provider_id": "00000000-0000-0000-0000-000000000000", "file_bucket": "file_bucket", "file_folder": "file_folder", "file_pref": {}, "version_count": 0 } ]
json
application/json

Delete an infographic

DELETE
https://api.genuineai.app/api/v1
/infographics/{id}

Removes the image and the HTML it was rendered from — deleting only the picture would leave the source holding storage with nothing pointing at it. Pass versions=all to remove every revision.

Delete an infographic › path Parameters

id
​string · uuid · required

Delete an infographic › query Parameters

versions
​string · enum
Enum values:
all

Delete an infographic › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete an infographic › Responses

Success

No data returned
DELETE/infographics/{id}
curl https://api.genuineai.app/api/v1/infographics/:id \ --request DELETE \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Rename an infographic

PATCH
https://api.genuineai.app/api/v1
/infographics/{id}

Renames the source and the image together, so the card and both downloads agree. Extensions are kept.

Rename an infographic › path Parameters

id
​string · uuid · required

Rename an infographic › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Rename an infographic › Request Body

file_name
​string · minLength: 1 · maxLength: 250 · required

Rename an infographic › Responses

Success

No data returned
PATCH/infographics/{id}
curl https://api.genuineai.app/api/v1/infographics/:id \ --request PATCH \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "file_name": "file_name" }'
Example Request Body
{ "file_name": "file_name" }
json
Example Responses
No example specified for this content type

Get who has access

GET
https://api.genuineai.app/api/v1
/infographics/{id}/acl

Returns who may read and edit this infographic. An empty result means unrestricted.

Get who has access › path Parameters

id
​string · uuid · required

Get who has access › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Get who has access › Responses

Success

No data returned
GET/infographics/{id}/acl
curl https://api.genuineai.app/api/v1/infographics/:id/acl \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Set who has access

PUT
https://api.genuineai.app/api/v1
/infographics/{id}/acl

Applies to the HTML source as well as the image. Sharing a picture whose source stayed private would hand someone a card they cannot open, edit or export.

Set who has access › path Parameters

id
​string · uuid · required

Set who has access › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Set who has access › Request Body

acl
​object · required

Set who has access › Responses

Success

No data returned
PUT/infographics/{id}/acl
curl https://api.genuineai.app/api/v1/infographics/:id/acl \ --request PUT \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "acl": {} }'
Example Request Body
{ "acl": {} }
json
Example Responses
No example specified for this content type

Download the HTML source

GET
https://api.genuineai.app/api/v1
/infographics/{id}/download-html

Returns the HTML the image was rendered from — the editable source, not the picture.

Download the HTML source › path Parameters

id
​string · uuid · required

Download the HTML source › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Download the HTML source › Responses

Success

No data returned
GET/infographics/{id}/download-html
curl https://api.genuineai.app/api/v1/infographics/:id/download-html \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Download the image

GET
https://api.genuineai.app/api/v1
/infographics/{id}/download-png

Returns the rendered image. For a fresh render after a data refresh, snapshot it first.

Download the image › path Parameters

id
​string · uuid · required

Download the image › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Download the image › Responses

Success

No data returned
GET/infographics/{id}/download-png
curl https://api.genuineai.app/api/v1/infographics/:id/download-png \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Refresh the data

POST
https://api.genuineai.app/api/v1
/infographics/{id}/refresh

Rebuilds the infographic from its stored brief, size and style and adds the result as the newest revision. Only the figures change.

Refresh the data › path Parameters

id
​string · uuid · required

Refresh the data › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Refresh the data › Responses

Success

No data returned
POST/infographics/{id}/refresh
curl https://api.genuineai.app/api/v1/infographics/:id/refresh \ --request POST \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Set the refresh schedule

PUT
https://api.genuineai.app/api/v1
/infographics/{id}/schedule

Re-reads the data source on a cadence and posts a new revision each time. Only an infographic with a stored brief can be scheduled — without one there is nothing to regenerate from.

Set the refresh schedule › path Parameters

id
​string · uuid · required

Set the refresh schedule › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Set the refresh schedule › Request Body

enabled
​boolean · required
cadence
​string · enum
Enum values:
daily
weekly
monthly

Set the refresh schedule › Responses

Success

No data returned
PUT/infographics/{id}/schedule
curl https://api.genuineai.app/api/v1/infographics/:id/schedule \ --request PUT \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "enabled": true, "cadence": "daily" }'
Example Request Body
{ "enabled": true, "cadence": "daily" }
json
Example Responses
No example specified for this content type

Render a PNG

POST
https://api.genuineai.app/api/v1
/infographics/{id}/snapshot-png

Renders the current HTML and files the image as the newest revision, so the list shows what the editor last saved. Used after an edit uploads new HTML.

Render a PNG › path Parameters

id
​string · uuid · required

Render a PNG › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Render a PNG › Request Body optional

replaces
​string · uuid

Render a PNG › Responses

Success

No data returned
POST/infographics/{id}/snapshot-png
curl https://api.genuineai.app/api/v1/infographics/:id/snapshot-png \ --request POST \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "replaces": "00000000-0000-0000-0000-000000000000" }'
Example Request Body
{ "replaces": "00000000-0000-0000-0000-000000000000" }
json
Example Responses
No example specified for this content type

Convert to a design

POST
https://api.genuineai.app/api/v1
/infographics/{id}/to-design

Turns a rendered page into something editable: charts and background become an image plate, and each piece of copy becomes a text layer at its measured position, font and color.

Requires the module-design license feature. Without it the request is refused with 403 license_required — see plans and modules.

Convert to a design › path Parameters

id
​string · uuid · required

Convert to a design › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Convert to a design › Responses

Success

No data returned
POST/infographics/{id}/to-design
curl https://api.genuineai.app/api/v1/infographics/:id/to-design \ --request POST \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

List versions

GET
https://api.genuineai.app/api/v1
/infographics/{id}/versions

Returns the earlier revisions of this infographic, newest first.

List versions › path Parameters

id
​string · uuid · required

List versions › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List versions › Responses

Success

No data returned
GET/infographics/{id}/versions
curl https://api.genuineai.app/api/v1/infographics/:id/versions \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

StudioPresentations