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
      List categoriesgetReplace categoriesput
    Studio
    Infographics
    Presentations
    Presentation templates
Website & content
Automation
Customer channels
Administration
Schemas
GenuineAI API
GenuineAI API

Design categories

The workspace's taxonomy for designs — the terms the design library files and filters by.


List categories

GET
https://api.genuineai.app/api/v1
/design-categories

The workspace's own design categories plus the product-level ones shared with it, in the order they are managed in, each with a count of the designs filed under it.

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

List categories › 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 categories › Responses

Success

​DesignCategory[]
GET/design-categories
curl https://api.genuineai.app/api/v1/design-categories \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
{ "categories": [ { "cat_id": "00000000-0000-0000-0000-000000000000", "cat_created": "2024-08-25T15:00:00Z", "cat_updated": "2024-08-25T15:00:00Z", "cat_managed_by": "cat_managed_by", "cat_name": "cat_name", "cat_order": 0, "cat_icon": "cat_icon", "cat_metadata": {}, "usage_count": 0 } ] }
json
application/json

Replace categories

PUT
https://api.genuineai.app/api/v1
/design-categories

Send the complete ordered list you want — this is a replacement, not a patch. An entry with an id is renamed in place and takes its position from the array; one without is created; anything you leave out is removed, including from the designs filed under it.

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

Replace categories › 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.

Replace categories › Request Body

​object[] · required

Replace categories › Responses

Success

​DesignCategory[]
PUT/design-categories
curl https://api.genuineai.app/api/v1/design-categories \ --request PUT \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "categories": [ { "cat_name": "cat_name", "cat_id": "00000000-0000-0000-0000-000000000000", "cat_icon": "cat_icon" } ] }'
Example Request Body
{ "categories": [ { "cat_name": "cat_name", "cat_id": "00000000-0000-0000-0000-000000000000", "cat_icon": "cat_icon" } ] }
json
Example Responses
{ "categories": [ { "cat_id": "00000000-0000-0000-0000-000000000000", "cat_created": "2024-08-25T15:00:00Z", "cat_updated": "2024-08-25T15:00:00Z", "cat_managed_by": "cat_managed_by", "cat_name": "cat_name", "cat_order": 0, "cat_icon": "cat_icon", "cat_metadata": {}, "usage_count": 0 } ] }
json
application/json

DesignsStudio