← Back to API Reference
/placements
Tag: placements
getPredefined placement slots on jerseys for the uniform builder
Parameters
| Name | In | Type | Format | Required | Description |
|---|---|---|---|---|---|
id | query | string | — | — | — |
name | query | string | — | — | Display name (e.g., "Back Top", "Front Center") |
code | query | string | — | — | Machine key (e.g., "back-top", "chest-center") |
surface | query | string | — | — | Garment surface: front, back, or sleeve |
anchor_x | query | string | — | — | X anchor position in canonical 2048x2048 space |
anchor_y | query | string | — | — | Y anchor position in canonical 2048x2048 space |
bounding_width | query | string | — | — | Print bounding area width in canonical pixels |
bounding_height | query | string | — | — | Print bounding area height in canonical pixels |
rotation_default | query | string | — | — | Default rotation angle in degrees |
scale_default | query | string | — | — | Default scale factor (1 = 100%) |
applies_to | query | string | — | — | Which element types can use this slot: text, image, or both |
description | query | string | — | — | Optional description of the placement |
is_active | query | string | — | — | Whether the placement is active/enabled |
sort_order | query | string | — | — | Display order for sorting |
created_by | query | string | — | — | — |
created_at | query | string | — | — | — |
updated_at | query | string | — | — | — |
deleted_at | query | string | — | — | Soft delete timestamp |
select | query | string | — | — | Filtering Columns |
order | query | string | — | — | Ordering |
Range | header | string | — | — | Limiting and Pagination |
Range-Unit | header | string | — | — | Limiting and Pagination |
offset | query | string | — | — | Limiting and Pagination |
limit | query | string | — | — | Limiting and Pagination |
Prefer | header | string | — | — | Preference |
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
| Name | In | Type | Format | Required | Description |
|---|---|---|---|---|---|
placements | body | object | — | — | placements |
select | query | string | — | — | Filtering Columns |
Prefer | header | string | — | — | Preference |
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
| Name | In | Type | Format | Required | Description |
|---|---|---|---|---|---|
id | query | string | — | — | — |
name | query | string | — | — | Display name (e.g., "Back Top", "Front Center") |
code | query | string | — | — | Machine key (e.g., "back-top", "chest-center") |
surface | query | string | — | — | Garment surface: front, back, or sleeve |
anchor_x | query | string | — | — | X anchor position in canonical 2048x2048 space |
anchor_y | query | string | — | — | Y anchor position in canonical 2048x2048 space |
bounding_width | query | string | — | — | Print bounding area width in canonical pixels |
bounding_height | query | string | — | — | Print bounding area height in canonical pixels |
rotation_default | query | string | — | — | Default rotation angle in degrees |
scale_default | query | string | — | — | Default scale factor (1 = 100%) |
applies_to | query | string | — | — | Which element types can use this slot: text, image, or both |
description | query | string | — | — | Optional description of the placement |
is_active | query | string | — | — | Whether the placement is active/enabled |
sort_order | query | string | — | — | Display order for sorting |
created_by | query | string | — | — | — |
created_at | query | string | — | — | — |
updated_at | query | string | — | — | — |
deleted_at | query | string | — | — | Soft delete timestamp |
placements | body | object | — | — | placements |
Prefer | header | string | — | — | Preference |
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
| Name | In | Type | Format | Required | Description |
|---|---|---|---|---|---|
id | query | string | — | — | — |
name | query | string | — | — | Display name (e.g., "Back Top", "Front Center") |
code | query | string | — | — | Machine key (e.g., "back-top", "chest-center") |
surface | query | string | — | — | Garment surface: front, back, or sleeve |
anchor_x | query | string | — | — | X anchor position in canonical 2048x2048 space |
anchor_y | query | string | — | — | Y anchor position in canonical 2048x2048 space |
bounding_width | query | string | — | — | Print bounding area width in canonical pixels |
bounding_height | query | string | — | — | Print bounding area height in canonical pixels |
rotation_default | query | string | — | — | Default rotation angle in degrees |
scale_default | query | string | — | — | Default scale factor (1 = 100%) |
applies_to | query | string | — | — | Which element types can use this slot: text, image, or both |
description | query | string | — | — | Optional description of the placement |
is_active | query | string | — | — | Whether the placement is active/enabled |
sort_order | query | string | — | — | Display order for sorting |
created_by | query | string | — | — | — |
created_at | query | string | — | — | — |
updated_at | query | string | — | — | — |
deleted_at | query | string | — | — | Soft delete timestamp |
Prefer | header | string | — | — | Preference |
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
| Column | Type | Format | Nullable | Default | Notes |
|---|---|---|---|---|---|
idPK | string | uuid | — | extensions.uuid_generate_v4() | This is a Primary Key. |
name | string | text | — | — | Display name (e.g., "Back Top", "Front Center") |
code | string | text | — | — | Machine key (e.g., "back-top", "chest-center") |
surface | string | text | — | — | Garment surface: front, back, or sleeve |
anchor_x | number | numeric | — | — | X anchor position in canonical 2048x2048 space |
anchor_y | number | numeric | — | — | Y anchor position in canonical 2048x2048 space |
bounding_width | number | numeric | ✓ | — | Print bounding area width in canonical pixels |
bounding_height | number | numeric | ✓ | — | Print bounding area height in canonical pixels |
rotation_default | number | numeric | — | 0 | Default rotation angle in degrees |
scale_default | number | numeric | — | 1 | Default scale factor (1 = 100%) |
applies_to | array | text[] | — | — | Which element types can use this slot: text, image, or both |
description | string | text | ✓ | — | Optional description of the placement |
is_active | boolean | boolean | — | Whether the placement is active/enabled | |
sort_order | integer | integer | — | 0 | Display order for sorting |
created_by | string | uuid | ✓ | — | — |
created_at | string | timestamp with time zone | ✓ | now() | — |
updated_at | string | timestamp with time zone | ✓ | now() | — |
deleted_at | string | timestamp with time zone | ✓ | — | Soft delete timestamp |