Entity reference · v1

personas

PERS-NNNNNNtable personassoft delete

User segments / archetypes that give feedback and benefit from features.

Endpoints

GET/api/v1/personasList personas

POST/api/v1/personasCreate personas

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

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

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

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

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

POST/api/v1/personas/{id}/links/feedbackAdd link

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

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

POST/api/v1/personas/{id}/links/themesAdd link

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

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

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

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

GET/api/v1/personas/{id}/links/productsList linked products

POST/api/v1/personas/{id}/links/productsAdd link

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

GET/api/v1/personas/{id}/links/modulesList linked modules

POST/api/v1/personas/{id}/links/modulesAdd link

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

Writable fields

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

Field	Type	Constraints	Notes
name*	string
role	string
company	string
avatar	string
description	text
goals	string[]
pain_points	string[]
revenue_impact	string
is_draft	boolean
metadata	json

Listing & filtering

Pagination: ?limit=50&offset=0 · max limit 200
Default sort: ?sort=name&order=asc
Sortable fields: created_at · updated_at · name · id_number
Search (?q=): name, role, description
Filters: ?company= ?revenue_impact= ?is_draft= , repeat any filter to OR multiple values
Trash: hidden by default; pass ?include_deleted=true
Expand: ?expand=feedback,themes

Examples

curlbash

curl 'https://productos.ca/api/v1/personas?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/personas. 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/personas?limit=3