Entity reference · v1

battle-cards

BTLC-NNNNNNtable battle_cardssoft delete

Battle cards per competitor with criteria + 1-5 ratings.

Endpoints

GET/api/v1/battle-cardsList battle-cards

POST/api/v1/battle-cardsCreate battle-cards

GET/api/v1/battle-cards/{id}Read one

PATCH/api/v1/battle-cards/{id}Update

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

POST/api/v1/battle-cards/{id}/restoreRestore from trash

Writable fields

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

Field	Type	Constraints
title	string
competitor_id	uuid
overview	text
our_strengths	json
their_strengths	json
key_differentiators	json
talk_track	text
objection_handling	json
status	string	`draft \| active \| archived`
last_reviewed_at	timestamp
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 · last_reviewed_at · id_number
Search (?q=): title, overview, talk_track
Filters: ?status= ?competitor_id= , repeat any filter to OR multiple values
Trash: hidden by default; pass ?include_deleted=true

Examples

curlbash

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