getInstancesForWidgetDescriptor
get
/ccadmin/v1/widgetDescriptors/{id}/instances
Get Instances For Widget Descriptor. Get all instances of a particular widget descriptor type.
Request
Supported Media Types
- application/json
Path Parameters
-
id(required): string
The ID of the widget descriptor
Query Parameters
-
includeLayoutAssociations: boolean
If set to true (default is false), layout associations of the instances is passed in endpoint response.
-
limit: integer
This is the field to determine number of records to be fetched per REST call. If provided returns paginated response.
-
offset: integer
This field determines the offset/starting index from which data to be fetched. If provided returns paginated response.
-
search: string
If search provided (default is empty), returns paginated response matching the search query param with display name of instances.
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : getInstancesForWidgetDescriptor_response
Type:
Show Source
object
-
items:
object items
Array of widget instances.
Nested Schema : items
Type:
object
Array of widget instances.
Show Source
-
descriptor:
object descriptor
Widget descriptor details
-
displayName:
string
The widget display name
-
repositoryId:
string
The Repository Id
Nested Schema : descriptor
Type:
object
Widget descriptor details
Show Source
-
editableWidget:
boolean
Whether the widget is editable
-
minWidth:
integer
The minimum width
-
repositoryId:
string
The Repository ID
Example Response (application/json)
[
{
"displayName":"Header - Basic Widget",
"repositoryId":"basicHeaderWidgetInst",
"descriptor":{
"repositoryId":"headerWidget",
"minWidth":1,
"editableWidget":true
}
},
{
"displayName":"Header Widget",
"repositoryId":"headerWidgetInst",
"descriptor":{
"repositoryId":"headerWidget",
"minWidth":1,
"editableWidget":true
}
}
]
Default Response
The error response
Root Schema : errorModel
Type:
Show Source
object
-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
errors:
array errors
An optional list of errors if multiple errors were encountered
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code
-
type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code