Entity reference · v1

team-members

TEAM-NNNNNNtable team_memberssoft delete

Workspace members with capacity and skills. Only admins and the owner create, edit or trash them; members assign them to Work.

A team member is a person on the workspace roster, linked to a sign-in through profile_id or not.

Work and initiatives

/api/v1/team-members/{id}/links/features and /links/initiatives assign the person to Work items and initiatives. Each link carries allocation_pct (0 to 100, default 50) and a free-text role.

Products and modules

/api/v1/team-members/{id}/links/products and /links/modules give the person a role on a product or module (Owner, Product Manager, a custom role up to 60 characters; default Contributor). These are the same rows as the product's and module's members links, read from the person's side. See Products entity.

Merging two team members moves the duplicate's Work, initiative, product and module links to the one kept.

Endpoints

GET/api/v1/team-membersList team-members

POST/api/v1/team-membersCreate team-members

GET/api/v1/team-members/{id}Read one

PATCH/api/v1/team-members/{id}Update

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

POST/api/v1/team-members/{id}/restoreRestore from trash

GET/api/v1/team-members/{id}/links/featuresList linked features

POST/api/v1/team-members/{id}/links/featuresAdd link (fields: role (string), allocation_pct (integer 0 to 100))

DELETE/api/v1/team-members/{id}/links/features/{targetId}Unlink

GET/api/v1/team-members/{id}/links/initiativesList linked initiatives

POST/api/v1/team-members/{id}/links/initiativesAdd link (fields: role (string), allocation_pct (integer 0 to 100))

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

GET/api/v1/team-members/{id}/links/productsList linked products

POST/api/v1/team-members/{id}/links/productsAdd link (fields: role (string))

DELETE/api/v1/team-members/{id}/links/products/{targetId}Unlink

GET/api/v1/team-members/{id}/links/modulesList linked modules

POST/api/v1/team-members/{id}/links/modulesAdd link (fields: role (string))

DELETE/api/v1/team-members/{id}/links/modules/{targetId}Unlink

Writable fields

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

Field	Type	Constraints	Notes
full_name*	string
email	string
role*	string
team	string
avatar_url	string
status	string	`active \| away \| offboarded`
capacity	integer	≥ 0 · ≤ 100
skills	string[]
profile_id	uuid
manager_id	uuid		Self-FK to team_members.id; powers the org chart hierarchy.
metadata	json

Listing & filtering

Pagination: ?limit=50&offset=0 · max limit 200
Default sort: ?sort=full_name&order=asc
Sortable fields: created_at · updated_at · full_name · capacity · id_number
Search (?q=): full_name, email, role
Filters: ?team= ?status= , repeat any filter to OR multiple values
Trash: hidden by default; pass ?include_deleted=true
Expand: ?expand=features,initiatives

Examples

curlbash

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