Entity reference · v1

themes

THM-NNNNNNtable themessoft delete

Patterns clustered from feedback. Trend chip + AI summary.

Endpoints

GET/api/v1/themesList themes

POST/api/v1/themesCreate themes

GET/api/v1/themes/{id}Read one

PATCH/api/v1/themes/{id}Update

DELETE/api/v1/themes/{id}Soft-delete (?hard=true to skip trash)

POST/api/v1/themes/{id}/restoreRestore from trash

GET/api/v1/themes/{id}/links/feedbackList linked feedback

POST/api/v1/themes/{id}/links/feedbackAdd link (fields: confidence (float 0 to 1))

DELETE/api/v1/themes/{id}/links/feedback/{targetId}Unlink

GET/api/v1/themes/{id}/links/featuresList linked features

POST/api/v1/themes/{id}/links/featuresAdd link

DELETE/api/v1/themes/{id}/links/features/{targetId}Unlink

GET/api/v1/themes/{id}/links/personasList linked personas

POST/api/v1/themes/{id}/links/personasAdd link

DELETE/api/v1/themes/{id}/links/personas/{targetId}Unlink

Writable fields

* required on create. PATCH treats every field as optional.

Field	Type	Constraints
title*	string
description	text
status	string	`new \| under-review \| planned \| in-progress \| emerging \| active \| mature \| archived`
category	string
trend	string	`up \| growing \| stable \| declining \| down`
weekly_growth	float
linked_initiative	string
ai_summary	text
module_id	uuid
is_draft	boolean
metadata	json

Listing & filtering

Pagination: ?limit=50&offset=0 · max limit 200
Default sort: ?sort=created_at&order=desc
Sortable fields: created_at · updated_at · title · weekly_growth · id_number
Search (?q=): title, description, ai_summary
Filters: ?status= ?trend= ?category= ?module_id= ?is_draft= , repeat any filter to OR multiple values
Trash: hidden by default; pass ?include_deleted=true
Expand: ?expand=feedback,features

Examples

curlbash

curl 'https://productos.ca/api/v1/themes?limit=10' \
  -H "Authorization: Bearer $TOKEN"

Try it out

Paste a token and hit a real endpoint. The request goes from your browser straight to /api/v1/themes. The token is held in this page only for the request and is never stored.

Try it out

API token

Issue tokens in Settings → API tokens. Token never leaves this page.

GET/api/v1/themes?limit=3