On this page
style
query · in the family Style
What it does
Look up one record — a style — the top of a product family.
A Style by id, within the caller's OWN org-group family; requires authentication. A cross-tenant id reads as null (not-found) AND trips the rootId tripwire server-side.
What happens
Reads only — changes nothing.
Who may call it
Capability area: Reading your records — Looking up and listing the records of your organization.
- Owner
- System Administrator
- Manager
- Associate Manager
- Warehouse Associate
- Sales Associate
- Cashier
- An API key whose scope allows
api:style
Arguments
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID ID! | yes | The id of the record. |
Returns
Style — styleType comes from the canned registry (simple | service | kit | bundle — all four realized; kit/bundle variants bear per-variant VariantComponent BOMs since the component slice) and is IMMUTABLE. The scheme is FROZEN once any Product exists. Org availability = the OrgStyle selection; zero dimensions = the corner-store single-cell case.
Example request
query ExampleStyle($id: ID!) {
style(id: $id) {
id
sysId
type
caption
status
parentId
rootId
createdAt
updatedAt
revisionNum
revision
styleType
brandId
sizeRunId
seasonIds
tagIds
code
taxCategory
}
}
Variables:
{
"id": "01900000-0000-7000-8000-37386ae00000"
}
Example response
{
"data": {
"style": {
"id": "01900000-0000-7000-8000-37386ae00000",
"sysId": "ST-EXMP-0000-000F",
"type": "Style",
"caption": "Blue jeans",
"status": "active",
"parentId": "01900000-0000-7000-8000-065235280000",
"rootId": "01900000-0000-7000-8000-a093dd800000",
"createdAt": "2027-01-31T00:00:00.000Z",
"updatedAt": "2027-01-31T00:00:00.000Z",
"revisionNum": 1,
"revision": "01900000-0000-7000-8000-b7960e180000",
"styleType": "simple",
"brandId": "01900000-0000-7000-8000-4067736b0000",
"sizeRunId": "01900000-0000-7000-8000-d314eddc0000",
"seasonIds": [
"01900000-0000-7000-8000-92b52b220000"
],
"tagIds": [
"01900000-0000-7000-8000-decd62770000"
],
"code": "BJ-001",
"taxCategory": "standard"
}
},
"extensions": {
"at": {
"callId": "01EXAMPLE-CALL-ID",
"version": {
"requested": null,
"serviced": {
"name": "genesis",
"number": 0
}
}
}
}
}
Errors this call can answer
VALIDATION/INVALID— Something in the request is not valid. (VALIDATION)AUTHN/REQUIRED— Sign in to do this. (AUTHN)AUTHZ/FORBIDDEN— Your role does not allow this action. (AUTHZ)RATE_LIMIT/THROTTLED— Too many requests in a short time. (RATE_LIMIT)NOT_FOUND/*— That record could not be found. (NOT_FOUND)