List Vistas
Lists the available vistas.
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
Query Parameters
Filters for vistas created by any of these users.
The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
textFilters for vistas of specific flavor.
Whether the default vistas should be fetched or not.
The maximum number of vistas to return. The default is '50', the maximum is '100'.
int32Filters for vistas accessible to the input members.
The iteration mode to use, otherwise if not set, then "after" is used.
"after" | "before"Filters for vistas of specific object types like works, parts etc.
ID of the group/member with whom the item is shared.
idRole ID of the group/member with whom the item is shared.
idDenotes whether to skip items of vista_group_item in response.
Fields to sort the vistas by and the direction to sort them.
Denotes the state of the vista group item.
Filters for vistas of the specific type.
Response Body
curl -X GET "https://api.devrev.ai/vistas.list?created_by=DEVU-12345&cursor=string&flavor=nnl&is_default=true&limit=0&members=DEVU-12345&mode=after&object_type=accounts&shared_with.member=string&shared_with.role=string&skip_items=true&sort_by=string&state=active&type=curated"{
"next_cursor": "string",
"prev_cursor": "string",
"vistas": [
{
"type": "curated",
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"is_default": true,
"name": "string",
"shared_with": [
{
"member": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"role": {
"display_id": "string",
"id": "string"
}
}
],
"items": [
{
"type": "article",
"display_id": "string",
"id": "string",
"article_type": "article",
"resource": {
"artifacts": [
{
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
}
],
"url": "string"
},
"title": "string"
}
]
}
]
}{
"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"
}