Entity reference · v1

initiatives

INIT-NNNNNNtable initiativessoft delete

Strategic bets that group features. Carry a hypothesis + success_metric.

Endpoints

GET/api/v1/initiativesList initiatives

POST/api/v1/initiativesCreate initiatives

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

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

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

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

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

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

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

GET/api/v1/initiatives/{id}/links/releasesList linked releases

POST/api/v1/initiatives/{id}/links/releasesAdd link

DELETE/api/v1/initiatives/{id}/links/releases/{targetId}Unlink

GET/api/v1/initiatives/{id}/links/membersList linked members

POST/api/v1/initiatives/{id}/links/membersAdd link (fields: role (string), allocation_pct (integer 0 to 100))

DELETE/api/v1/initiatives/{id}/links/members/{targetId}Unlink

Writable fields

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

Field	Type	Constraints
title*	string
problem	text
hypothesis	text
status	string	`discovery \| planned \| in-progress \| shipped \| proposed \| active \| completed \| paused \| off-track \| at-risk`
progress	integer	≥ 0 · ≤ 100
owner	string
team	string
target_date	date
theme_id	uuid
success_metric	json
jira_link	string
figma_link	string
external_links	json
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 · progress · target_date · id_number
Search (?q=): title, problem, hypothesis
Filters: ?status= ?owner= ?team= ?theme_id= ?is_draft= , repeat any filter to OR multiple values
Trash: hidden by default; pass ?include_deleted=true
Expand: ?expand=features,releases

Examples

curlbash

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