List Vistas Groups (POST)
Lists the available vista group items.
All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request.
How do I find my token?
In: header
Filters for vista group items of the specific type.
Filters for vista group items which have one of the parts linked as its ancestor part or primary part.
The filter for applies to part.
Filter for vistas group item created by any of these users.
Provides ways to specify date ranges on objects.
Filters for objects created after the provided timestamp (inclusive).
date-timeFilters for objects created before the provided timestamp (inclusive).
date-timeProvides preset types for date filter.
The range starts from the current timestamp and continues for the past n days.
0 <= value <= 4294967295The range starts from the current timestamp and continues for the next n days.
0 <= value <= 4294967295The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
textProvides ways to specify date ranges on objects.
Filters for objects created after the provided timestamp (inclusive).
date-timeFilters for objects created before the provided timestamp (inclusive).
date-timeProvides preset types for date filter.
The range starts from the current timestamp and continues for the past n days.
0 <= value <= 4294967295The range starts from the current timestamp and continues for the next n days.
0 <= value <= 4294967295Filters for vista group items of the specific group object type.
The request to get information about a list of vista groups.
int32The iteration mode to use. If "after", then entries after the provided cursor will be returned, or if no cursor is provided, then from the beginning. If "before", then entries before the provided cursor will be returned, or if no cursor is provided, then from the end. Entries will always be returned in the specified sort-by order.
"after" | "before"Provides ways to specify date ranges on objects.
Filters for objects created after the provided timestamp (inclusive).
date-timeFilters for objects created before the provided timestamp (inclusive).
date-timeProvides preset types for date filter.
The range starts from the current timestamp and continues for the past n days.
0 <= value <= 4294967295The range starts from the current timestamp and continues for the next n days.
0 <= value <= 4294967295Parent ID of the vista group item.
Comma-separated fields to sort the objects by.
Provides ways to specify date ranges on objects.
Filters for objects created after the provided timestamp (inclusive).
date-timeFilters for objects created before the provided timestamp (inclusive).
date-timeProvides preset types for date filter.
The range starts from the current timestamp and continues for the past n days.
0 <= value <= 4294967295The range starts from the current timestamp and continues for the next n days.
0 <= value <= 4294967295Denotes the state of the vista group item.
Response Body
curl -X POST "https://api.devrev.ai/vistas.groups.list" \ -H "Content-Type: application/json" \ -d '{}'{
"next_cursor": "string",
"prev_cursor": "string",
"vista_group": [
{
"object_type": "conversations",
"end_date": "2023-01-01T12:00:00.000Z",
"id": "string",
"name": "string",
"parent": {
"type": "string",
"display_id": "string",
"flavor": "nnl",
"id": "VISTA-12345",
"name": "string"
},
"start_date": "2023-01-01T12:00:00.000Z",
"state": "active",
"type": "curated"
}
]
}{
"detail": "string",
"message": "string",
"type": "artifact_already_attached_to_a_parent",
"existing_parent": "string",
"is_same": true
}{
"detail": "string",
"message": "string",
"type": "unauthenticated"
}{
"detail": "string",
"message": "string",
"type": "forbidden"
}{
"detail": "string",
"message": "string",
"type": "too_many_requests",
"retry_after": 0
}{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}