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
Website & content
Automation
Customer channels
Administration
    Users
    Roles
    Workspace settings
    Audit
    Storage
    Usage breakdown
    Media tag groups
      List tag groupsgetReplace tag groupspost
    Media status flows
    Issued share links
    Social connections
    Social calendar
Schemas
GenuineAI API
GenuineAI API

Media tag groups

The tag groups the media library files by, including the ones AI analysis fills in — defining them, and replacing the structure wholesale.


List tag groups

GET
https://api.genuineai.app/api/v1
/admin/media-tags

Returns a library's tag groups and the tags in each, including the groups AI analysis fills in. scope picks the library — media for the photo library, docs for the document library — and defaults to media. The two vocabularies are independent even where a group name appears in both.

List tag groups › query Parameters

cursor
​string · maxLength: 512 · pattern: ^[A-Za-z0-9_-]+$
limit
​integer
mt_active
​boolean
mt_ai_detection
​boolean
mt_group
​string
offset
​integer · min: 0
scope
​string · enum
Enum values:
media
docs
sort
​string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$

List tag groups › 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 tag groups › Responses

Success

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

Replace tag groups

POST
https://api.genuineai.app/api/v1
/admin/media-tags

Send the whole structure — this replaces it rather than merging into it. It replaces one scope only, so saving the photo library's groups leaves the document library's alone.

Replace tag groups › 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 tag groups › Request Body

​object[] · required
scope
​string · enum
Enum values:
media
docs

Replace tag groups › Responses

Success

No data returned
POST/admin/media-tags
curl https://api.genuineai.app/api/v1/admin/media-tags \ --request POST \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "scope": "media", "groups": [ { "name": "name", "tags": [ {} ] } ] }'
Example Request Body
{ "scope": "media", "groups": [ { "name": "name", "tags": [ {} ] } ] }
json
Example Responses
No example specified for this content type

Usage breakdownMedia status flows