← Back to API Reference

/placements

Tag: placements

getPredefined placement slots on jerseys for the uniform builder

Parameters

NameInTypeFormatRequiredDescription
idquerystring
namequerystringDisplay name (e.g., "Back Top", "Front Center")
codequerystringMachine key (e.g., "back-top", "chest-center")
surfacequerystringGarment surface: front, back, or sleeve
anchor_xquerystringX anchor position in canonical 2048x2048 space
anchor_yquerystringY anchor position in canonical 2048x2048 space
bounding_widthquerystringPrint bounding area width in canonical pixels
bounding_heightquerystringPrint bounding area height in canonical pixels
rotation_defaultquerystringDefault rotation angle in degrees
scale_defaultquerystringDefault scale factor (1 = 100%)
applies_toquerystringWhich element types can use this slot: text, image, or both
descriptionquerystringOptional description of the placement
is_activequerystringWhether the placement is active/enabled
sort_orderquerystringDisplay order for sorting
created_byquerystring
created_atquerystring
updated_atquerystring
deleted_atquerystringSoft delete timestamp
selectquerystringFiltering Columns
orderquerystringOrdering
RangeheaderstringLimiting and Pagination
Range-UnitheaderstringLimiting and Pagination
offsetquerystringLimiting and Pagination
limitquerystringLimiting and Pagination
PreferheaderstringPreference

Example

bash
curl "https://szkofkgbqogzlbqtcrke.supabase.co/rest/v1/placements?select=*&limit=10" \
  -H "apikey: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

200OK
206Partial Content

postPredefined placement slots on jerseys for the uniform builder

Parameters

NameInTypeFormatRequiredDescription
placementsbodyobjectplacements
selectquerystringFiltering Columns
PreferheaderstringPreference

Example

bash
curl -X POST "https://szkofkgbqogzlbqtcrke.supabase.co/rest/v1/placements" \
  -H "apikey: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: return=representation" \
  -d '{
  "name": "example",
  "code": "example",
  "surface": "example",
  "anchor_x": 0.00,
  "anchor_y": 0.00
}'

Responses

201Created

patchPredefined placement slots on jerseys for the uniform builder

Parameters

NameInTypeFormatRequiredDescription
idquerystring
namequerystringDisplay name (e.g., "Back Top", "Front Center")
codequerystringMachine key (e.g., "back-top", "chest-center")
surfacequerystringGarment surface: front, back, or sleeve
anchor_xquerystringX anchor position in canonical 2048x2048 space
anchor_yquerystringY anchor position in canonical 2048x2048 space
bounding_widthquerystringPrint bounding area width in canonical pixels
bounding_heightquerystringPrint bounding area height in canonical pixels
rotation_defaultquerystringDefault rotation angle in degrees
scale_defaultquerystringDefault scale factor (1 = 100%)
applies_toquerystringWhich element types can use this slot: text, image, or both
descriptionquerystringOptional description of the placement
is_activequerystringWhether the placement is active/enabled
sort_orderquerystringDisplay order for sorting
created_byquerystring
created_atquerystring
updated_atquerystring
deleted_atquerystringSoft delete timestamp
placementsbodyobjectplacements
PreferheaderstringPreference

Example

bash
curl -X PATCH "https://szkofkgbqogzlbqtcrke.supabase.co/rest/v1/placements?id=eq.YOUR_ID" \
  -H "apikey: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: return=representation" \
  -d '{"name": "example"}'

Responses

204No Content

deletePredefined placement slots on jerseys for the uniform builder

Parameters

NameInTypeFormatRequiredDescription
idquerystring
namequerystringDisplay name (e.g., "Back Top", "Front Center")
codequerystringMachine key (e.g., "back-top", "chest-center")
surfacequerystringGarment surface: front, back, or sleeve
anchor_xquerystringX anchor position in canonical 2048x2048 space
anchor_yquerystringY anchor position in canonical 2048x2048 space
bounding_widthquerystringPrint bounding area width in canonical pixels
bounding_heightquerystringPrint bounding area height in canonical pixels
rotation_defaultquerystringDefault rotation angle in degrees
scale_defaultquerystringDefault scale factor (1 = 100%)
applies_toquerystringWhich element types can use this slot: text, image, or both
descriptionquerystringOptional description of the placement
is_activequerystringWhether the placement is active/enabled
sort_orderquerystringDisplay order for sorting
created_byquerystring
created_atquerystring
updated_atquerystring
deleted_atquerystringSoft delete timestamp
PreferheaderstringPreference

Example

bash
curl -X DELETE "https://szkofkgbqogzlbqtcrke.supabase.co/rest/v1/placements?id=eq.YOUR_ID" \
  -H "apikey: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

204No Content

Schema

Predefined placement slots on jerseys for the uniform builder

ColumnTypeFormatNullableDefaultNotes
idPK
stringuuidextensions.uuid_generate_v4()This is a Primary Key.
name
stringtextDisplay name (e.g., "Back Top", "Front Center")
code
stringtextMachine key (e.g., "back-top", "chest-center")
surface
stringtextGarment surface: front, back, or sleeve
anchor_x
numbernumericX anchor position in canonical 2048x2048 space
anchor_y
numbernumericY anchor position in canonical 2048x2048 space
bounding_width
numbernumericPrint bounding area width in canonical pixels
bounding_height
numbernumericPrint bounding area height in canonical pixels
rotation_default
numbernumeric0Default rotation angle in degrees
scale_default
numbernumeric1Default scale factor (1 = 100%)
applies_to
arraytext[]Which element types can use this slot: text, image, or both
description
stringtextOptional description of the placement
is_active
booleanbooleanWhether the placement is active/enabled
sort_order
integerinteger0Display order for sorting
created_by
stringuuid
created_at
stringtimestamp with time zonenow()
updated_at
stringtimestamp with time zonenow()
deleted_at
stringtimestamp with time zoneSoft delete timestamp