Skip to main content
GET
Error

Query Parameters

A free-text term matched as a substring against both the color group name and userDefinedId.

Name
string

Filters to color groups whose name exactly matches this value.

UserDefinedId
string

Filters to color groups whose userDefinedId exactly matches this value.

State
enum<string>

Filters the results to color groups in the given state. Whether the color group is active and available for assigning to colors, or has been deactivated.

Available options:
active,
inactive
sort
object[]

Repeat the parameter per sort column: sort[0].property=<column>&sort[0].order=Ascending|Descending, sort[1].... for a secondary column. order accepts asc, desc, ascending or descending (case-insensitive) and may also be spelled direction. Mutually exclusive with cursor. Sortable columns include: Id, Name, UserDefinedId.

pageSize

The maximum number of color groups to return per page. Defaults to 30, maximum 100.

pageNumber

The 1-based page number to return. Defaults to 1.

cursor
string

An opaque keyset pagination token from a previous response. Mutually exclusive with the filter, sort, pageSize and pageNumber parameters.

Response

OK

status
enum<string>
required

The coarse outcome of the request, indicating whether it succeeded or failed.

Available options:
success,
error
code
string
required

The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire.

data
object[]
required

The page of results, always an array. An empty page is an empty array rather than null or an omitted field.

pagination
object
required

Paging metadata for this response, carrying whether more rows remain and the cursor used to request the next page.