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
    Files
    Uploads
    Stock photos
    Downloads
    File versions
    File analysis
      Merge analysis resultsputPreview an analysispostReanalyze a filepostReanalyze filespost
    Media analysis schemas
    Faces
    Albums
    People
    Media tags
    Share links
    Publications
    Distribution control
AI
Documents
Knowledge
Creative
Website & content
Automation
Customer channels
Administration
Schemas
GenuineAI API
GenuineAI API

File analysis

What AI read out of a file — the fields it filled, and the markdown rendition it read them from.


Merge analysis results

PUT
https://api.genuineai.app/api/v1
/files/{id}/analysis

Merges values into what AI read out of the file, field by field — fields absent from the body keep the values the analysis gave them.

Merge analysis results › path Parameters

id
​string · uuid · required

Merge analysis results › 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.

Merge analysis results › Request Body optional

analysis
​object

Merge analysis results › Responses

Success

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

Preview an analysis

POST
https://api.genuineai.app/api/v1
/files/{id}/analyze-preview

A dry run: shows what a profile would produce, and writes nothing to the file.

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

Preview an analysis › path Parameters

id
​string · uuid · required

Preview an analysis › 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.

Preview an analysis › Request Body

form_id
​string · uuid · required

Preview an analysis › Responses

Success

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

Reanalyze a file

POST
https://api.genuineai.app/api/v1
/files/{id}/reanalyze

Runs a model — it consumes credits and counts against the expensive rate-limit tier.

Reanalyze a file › path Parameters

id
​string · uuid · required

Reanalyze a file › 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.

Reanalyze a file › Responses

Success

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

Reanalyze files

POST
https://api.genuineai.app/api/v1
/files/actions/reanalyze

Queues an analysis run over several files. Returns once queued, not once analyzed.

Reanalyze files › 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.

Reanalyze files › Request Body

file_ids
​string[] · required

Reanalyze files › Responses

Success

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

File versionsMedia analysis schemas