Skip to content

Collector GraphQL API🔗

Time🔗

Description: 'Time' represents a timestamp conforming to the RFC3339 standard

Map🔗

Any🔗

PromVector🔗

Description: 'PromVector' is a custom scalar that is a one to one representation of the equivalent Prometheus API type you can see here https://pkg.go.dev/github.com/prometheus/common/model?tab=doc#Vector . This type is returned by numerous Prometheus graphQL queries.

PromSample🔗

Description: 'PromSample' is a custom scalar that is a one to one representation of the equivalent Prometheus API type you can see here https://pkg.go.dev/github.com/prometheus/common/model?tab=doc#Sample . This type is returned by some Prometheus graphQL queries.

PromMatrix🔗

Description: 'PromMatrix' is a custom scalar that is a one to one representation of the equivalent Prometheus API type you can find more information on in the link over 'Vector'. Matrix is currently only returned by one graphql endpoint.

Hosts🔗

Description: 'Hosts' is a custom scalar representing a map type where the 'key' is the IP address and the 'value' is the list of associated hostnames

KubernetesConfig🔗

Description: 'KubernetesConfig' is a custom scalar representing an arbitrary YAML formatted Kubernetes configuration

StringSlice🔗

EmailAddress🔗

Description: EmailAddress is a string type that must be of the 'foo@bar.com' or ' foo@bar.com' format

NetworkCIDR🔗

Description: NetworkCIDR is a string type that must be of the standard '192.0.2.0/24' CIDR format

EndpointCredentials🔗

DeploymentStatus🔗

Description: 'DeploymentStatus' is a custom scalar representing a enum of helm status

ChartStatus🔗

Description: 'ChartStatus' is a custom scalar representing a map that holds chart status values with different keys associated to chart name,version,status

Uint🔗

Description: Uint is the 32 or 64 bit unsigned counterpart to Int

Proxy🔗

Description: 'proxy' is a custom scalar representing string value used for network proxy values. The following are all valid values for proxy https://auto:pass@autohostname.com:40,http://www.example.com,https://localhost:8080 https://localhost.test.com , https://test@t.com

ConfigStatus🔗

RBACObject🔗

RBACAction🔗

Query🔗

Description: Query Prometheus Endpoint

Fields🔗

Field Type Description Arguments
node Node id: ID
getCluster Cluster Get cluster by ID clusterID: ID
getClusterBacklogCount ClusterNodeTimeSeries clusterID: ID, timeRange: TimeRange
getClusterBacklogAge ClusterNodeTimeSeries clusterID: ID, timeRange: TimeRange
getClusterTransmitBytes ClusterNodeTimeSeries clusterID: ID, timeRange: TimeRange
getClusterReceiveBytes ClusterNodeTimeSeries clusterID: ID, timeRange: TimeRange
getClustersByIDs Cluster Get clusters by IDs clusterIDs: ID
getClusterNode ClusterNode clusterID: ID, clusterNodeInput: ClusterNodeInput
getAllClusters Cluster Get all clusters provisioned on the tenant role: String
getClusterConfig KubernetesConfig Get a cluster's config clusterID: ID
getClusterImageV2 Image Get a cluster's image download link. input: ClusterImageInput
getClusterImage Image Deprecated, use getClusterImageV2 instead for consolidated inputs. clusterID: ID, imageType: ImageType, launchConsole: Boolean, awsDetails: AWSDetails, gcpDetails: GCPDetails
getCloudZones CloudRegion Get a cloud service region and zones imageType: ImageType
getClusterCredentials Credentials Get a cluster's credentials clusterID: ID
getHosts Hosts Get all of the host->address mappings associated with a given cluster clusterID: ID
getClusterActivationDetails Activation clusterID: ID
getSystemByRole System role: String
getOSConfig OSConfig clusterID: ID, nodeName: String
getAllOSConfigs OSConfig clusterID: ID
getClusterStatuses Status Get a cluster's statuses and helm resources deployed clusterID: ID
getClusterDeploymentStatus ChartStatus Get the status of a cluster deployment clusterID: ID, deploymentID: ID
getChart Chart Get a single Helm chart by name chartName: String
getAllCharts ChartList Get all of the Helm charts available for deployment to any cluster
getBillOfMaterials BillOfMaterials
getClusterDeployment Deployment Get a single deployment under a collector clusterID: ID, deploymentID: ID
getAllClusterDeployments Deployment Get all of the deployments under a collector clusterID: ID
getDeploymentEndpoint Endpoint Get an endpoint configured for a given deployment clusterID: ID, deploymentID: ID, endpointID: ID
getAllDeploymentEndpoints Endpoint Get all of the endpoints configured for a given deployment clusterID: ID, deploymentID: ID
getDeploymentEndpointCredentialsValidityPeriod ValidityPeriod Get EndpointCredential validity period clusterID: ID, deploymentID: ID, endpointID: ID
getAWSRegions String Fetch list of AWS regions where we have images available
getRoleDeployments Deployment Get deployments to be installed on every cluster of a given role. role: String
getRoleDeployment Deployment Get a role based deployment by ID. deploymentID: ID
getAllCollectorsOverview CollectorOverview Get all collector overview data for the given role and time range role: String, timeRange: TimeRange
getCollectorMetrics CollectorMetrics Get collector data flow metrics over a given time range timeRange: TimeRange
getAggregateRateByCollector AggregateRateByCollector Get aggregated data flow rate metrics for a given collector over a given time range clusterID: ID, timeRange: TimeRange
getFlowRate FlowRate Get flow rate metrics for a given collector over a given time range clusterID: ID, timeRange: TimeRange
getLogLastSeenMetrics LogLastSeenMetrics Get last seen metrics for all available log sources for a given cluster.
If no clusterId is specified, this will return all log sources metrics for all existing clusters
clusterID: ID
getDataSourceMetrics DataSourceMetrics Get metrics for all available data sources for a given cluster in: GetDataSourceMetricsArguments
syslogMessageCountV2 SyslogMessageCountV2 Get syslog message counts for a given cluster or data source in: SyslogMessageCountV2Arguments
getScheduledService ScheduledService ID: String
getClustersPasswordHash String Get a cluster's password hash clusterID: ID
getDataCollectors DataCollectorResult Searches and/or aggregates on Data collectors cql schema input: QlQueryInput

ID🔗

Description: The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

String🔗

Description: The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Boolean🔗

Description: The Boolean scalar type represents true or false.

Mutation🔗

Fields🔗

Field Type Description Arguments
createCluster Cluster Create a new cluster of a given role clusterInput: ClusterInput
createHAClusterStaticConfig Cluster Create a cluster with clusterNodes containing static ips clusterInput: HAStaticClusterInput
updateCluster Cluster Update a cluster clusterID: ID, clusterInput: ClusterInput
deleteCluster Deleted Delete a cluster clusterID: ID
createOSConfig OSConfig input: OSConfigInput
updateOSConfig OSConfig input: OSConfigInput
deleteOSConfig String clusterID: ID, nodeName: String
addHost Hosts Add a address:hostname mapping to a given cluster clusterID: ID, hostInput: HostsInput
deleteHost Deleted Remove an address:hostname mapping from a given cluster by providing the IP address and associated host name clusterID: ID, address: String
createClusterStatus Status Create the initial deployment status of a given cluster clusterID: ID, statusInput: StatusInput
updateClusterStatus Status Update the deployment status of a given cluster clusterID: ID, statusInput: StatusInput
deleteClusterStatus Deleted Delete the deployment status of a given cluster clusterID: ID, deploymentID: ID
createClusterDeployment Deployment Create a deployment local to a given cluster clusterID: ID, deploymentInput: DeploymentInput
updateClusterDeployment Deployment Deprecated, use updateClusterDeploymentV2 instead clusterID: ID, deploymentID: ID, deploymentInput: DeploymentInput
updateClusterDeploymentV2 Deployment Update a deployment on a given cluster version2 clusterID: ID, deploymentID: ID, updateDeploymentInput: UpdateDeploymentInput
deleteClusterDeployment Deleted Delete a deployment on a given cluster clusterID: ID, deploymentID: ID
createEndpoint Endpoint Create an endpoint for a given cluster clusterID: ID, deploymentID: ID, endpointInput: EndpointInput
updateEndpoint Endpoint Update an endpoint for a given cluster clusterID: ID, deploymentID: ID, endpointID: ID, endpointInput: EndpointInput
deleteEndpoint Deleted Delete an endpoint for a given cluster clusterID: ID, deploymentID: ID, endpointID: ID
createRoleDeployment Deployment Create a deployment to be installed on every cluster of a given role. Only Secureworks admins can reach this endpoint. role: String, deploymentInput: DeploymentInput
updateRoleDeployment Deployment Update a system deployment by ID. Only Secureworks admins can reach this endpoint. deploymentID: ID, deploymentInput: DeploymentInput
deleteRoleDeployment Deleted Delete a system deployment by ID. Only Secureworks admins can reach this endpoint. deploymentID: ID
updateScheduledService ScheduledService scheduledServiceInput: ScheduledServiceInput
createService Service serviceInput: CreateServiceInput

Node🔗

Fields🔗

Field Type Description Arguments
id ID

ClusterNode🔗

Fields🔗

Field Type Description Arguments
createdAt Time
updatedAt Time
id ID
name String
description String
network Network
health String
registration Registration
host String

Cluster🔗

Description: The cluster structure represents the attributes of a data collector

Fields🔗

Field Type Description Arguments
createdAt Time
updatedAt Time
id ID
role String
name String
type String
clusterType ClusterType
description String
network Network
deployments Deployment
status Status
health String
healthState String
registration Registration
maintenanceDay DayType
maintenanceStartHour Int
maintenanceDuration Int
clusterNodes ClusterNode
isHa Boolean
haCidrBlock String
serviceTrack ServiceTrack
partnerTenantName String

Int🔗

Description: The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

CloudRegion🔗

Fields🔗

Field Type Description Arguments
region String
zones String

Service🔗

Fields🔗

Field Type Description Arguments
id ID
createdAt Time
updatedAt Time
upgradeVersion String
installFile String
verificationFile String
name String
reboot Boolean

ScheduledService🔗

Fields🔗

Field Type Description Arguments
id ID
createdAt Time
updatedAt Time
status String
clientStatus String
clusterNodeID ID
clusterID String
deferred Boolean
service Service
endDate Time
startDate Time
retries Int

ServiceTrack🔗

Fields🔗

Field Type Description Arguments
scheduledServices ScheduledService
serviceHistories ServiceHistory

ServiceHistory🔗

Fields🔗

Field Type Description Arguments
id ID
createdAt Time
updatedAt Time
name String
startDate Time
endDate Time
clusterNodeID ID
clusterID String
serviceID ID
status String
upgradeVersion String

ScheduledServiceInput🔗

Fields🔗

Field Type Description Arguments
ID ID
clusterNodeID ID
status String
retries Int

ClusterScheduledServiceInput🔗

Fields🔗

Field Type Description Arguments
id ID
clusterNodeID ID
deferred Boolean
serviceID ID
startDate Time
endDate Time

CreateServiceInput🔗

Fields🔗

Field Type Description Arguments
name String
upgradeVersion String
installFile String
verificationFile String
reboot Boolean
deleteSchedule Boolean

OSConfig🔗

Fields🔗

Field Type Description Arguments
createdAt Time
updatedAt Time
clusterID ID
nodeName String
status ConfigStatus
statusMessage String
dhcp Boolean
hostname String
hosts Hosts
address String
mask String
gateway String
dns StringSlice
ntp StringSlice
proxy Proxy

OSConfigInput🔗

Fields🔗

Field Type Description Arguments
clusterID ID
nodeName String
status ConfigStatus
statusMessage String
dhcp Boolean
hostname String
hosts HostsInput
address String
mask String
gateway String
dns String
ntp String
proxy Proxy

Activation🔗

Fields🔗

Field Type Description Arguments
code String
id String
region String

CollectorOverview🔗

Description: CollectorOverview combines a Cluster with its corresponding lastSeen and averageRate metrics. Check the CollectorMetrics type for more information on the latter.

Fields🔗

Field Type Description Arguments
cluster Cluster
lastSeen PromSample
averageRate PromSample

ClusterInput🔗

Description: ClusterInput is the corresponding input type for a cluster object.

Fields🔗

Field Type Description Arguments
name String
description String
network NetworkInput
role String
clusterType ClusterType
registration RegistrationInput
maintenance MaintenanceInput
clusterNodes ClusterNodeInput
isHa Boolean
haCidrBlock String
haCidrBlockArray String
scheduledServices ClusterScheduledServiceInput

HAStaticClusterInput🔗

Description: ClusterInput is the corresponding input type for a cluster object.

Fields🔗

Field Type Description Arguments
name String
description String
network NetworkInput
role String
clusterType ClusterType
registration RegistrationInput
maintenance MaintenanceInput
clusterNodes ClusterNodeInput
haCidrBlock String
haCidrBlockArray String

MaintenanceInput🔗

Description: Input used to establish a maintenance window for a cluster object, durations specified in hours

Fields🔗

Field Type Description Arguments
day DayType
startHour Int
duration Int

DayType🔗

Description: DayType holds the available and supported days to perform maintenance

ClusterNodeInput🔗

Description: ClusterInput is the corresponding input type for a cluster object.

Fields🔗

Field Type Description Arguments
name String
description String
network NetworkInput
registration RegistrationInput
host String

ClusterImageInput🔗

Description: Input used to identify cluster image to download

Fields🔗

Field Type Description Arguments
clusterID ID
imageType ImageType
launchConsole Boolean
awsDetails AWSDetailsV2
gcpDetails GCPDetailsV2

Deleted🔗

Description: Deleted represents a structure containing metadata related the action of deleting an arbitrary object

Fields🔗

Field Type Description Arguments
type String
id String
successful Boolean

Deployment🔗

Description: Deployment defines helm package and config

Fields🔗

Field Type Description Arguments
createdAt Time
updatedAt Time
id ID
role String
name String
description String
chart String
version String
config Map
status Status
endpoints Endpoint
alertable Boolean

DeploymentInput🔗

Description: DeploymentInput is the corresponding input type for a deployment object

Fields🔗

Field Type Description Arguments
name String
description String
chart String
version String
config Map
endpoints EndpointInput
alertable Boolean

UpdateDeploymentInput🔗

Description: UpdateDeploymentInput is the corresponding input type for a updating deployment object

Fields🔗

Field Type Description Arguments
name String
description String
version String
config Map
alertable Boolean

Endpoint🔗

Description: Endpoint defines API endpoints and credentials that applications would collect data from

Fields🔗

Field Type Description Arguments
createdAt Time
updatedAt Time
id ID
description String
address String
port Int
validity ValidityPeriod
credentials EndpointCredentials

EndpointInput🔗

Description: EndpointInput is the corresponding input type for an endpoint object

Fields🔗

Field Type Description Arguments
description String
address String
port Int
credentials EndpointCredentials

ValidityPeriod🔗

Fields🔗

Field Type Description Arguments
from Uint
until Uint

Image🔗

Description: Image represents the object that contains a given cluster's image metadata (such as an image download link)

Fields🔗

Field Type Description Arguments
location String

Registration🔗

Description: Registration represents the object that contains a given cluster's SSM id and region information

Fields🔗

Field Type Description Arguments
id ID
region String

RegistrationInput🔗

Description: RegistrationInput is the corresponding input type for a registration object

Fields🔗

Field Type Description Arguments
id ID
region String

Network🔗

Description: The network structure represents the network configuration attributes for a given data collector

Fields🔗

Field Type Description Arguments
dhcp Boolean
hostname String
hosts Hosts
address String
mask String
gateway String
dns StringSlice
ntp StringSlice
proxy Proxy

NetworkInput🔗

Description: NetworkInput is the corresponding input type for a network object

Fields🔗

Field Type Description Arguments
dhcp Boolean
hostname String
hosts HostsInput
address String
mask String
gateway String
dns String
ntp String
proxy Proxy

HostsInput🔗

Description: The hosts input structure represents a set ip address->hostname mappings used by a data collector. These host alias mappings can be considered as analogous to an /etc/hosts file

Fields🔗

Field Type Description Arguments
address String
hostname String

Status🔗

Description: The status structure represents an overview of a collector's health and readiness status with regards to its own deployments

Fields🔗

Field Type Description Arguments
name String
createdAt Time
updatedAt Time
id ID
status ChartStatus

StatusInput🔗

Description: StatusInput is the corresponding input type for a status object

Fields🔗

Field Type Description Arguments
deploymentID String
name String
status ChartStatus

System🔗

Fields🔗

Field Type Description Arguments
updatedAt Time
id Int
deployments Deployment

ChartList🔗

Description: The chart list structure represents a list of 'helm chart' entries available for installation in our repositories

Fields🔗

Field Type Description Arguments
APIVersion String
Entries Any
Generated Time

Chart🔗

Description: The chart structure represents the the attributes associated with a given helm chart

Fields🔗

Field Type Description Arguments
apiVersion String
appVersion String
name String
description String
icon String
home String
keywords String
annotations Map
version String
digest String
urls String
metaData Any

BillOfMaterials🔗

Fields🔗

Field Type Description Arguments
location String

Credentials🔗

Description: The credentials structure represents a set of credential attributes with regards to local access for a given collector

Fields🔗

Field Type Description Arguments
password String
passwordHash String
privateKey String
publicKey String
passwordHistory PasswordHistory
setDate Time

PasswordHistory🔗

Fields🔗

Field Type Description Arguments
password String
passwordHash String
setDate Time

PasswordHistoryInput🔗

Fields🔗

Field Type Description Arguments
password String
passwordHash String
setDate Time

CredentialsInput🔗

Description: The credentialsInput structure represents a set of credential attributes with regards to local access for a given collector

Fields🔗

Field Type Description Arguments
password String
passwordHash String
privateKey String
publicKey String
passwordHistory PasswordHistoryInput
setDate Time

CollectorMetrics🔗

Description: The collector metrics structure represents a set of collector data metrics

Fields🔗

Field Type Description Arguments
lastSeen PromVector Selecting this field yields the rough equivalent of: max(collector_last_seen) by (collector)
averageRate PromVector Selecting this field yields the rough equivalent of: avg(rate(collector_conversation_bytes[TimeRange])) by (collector)

AggregateRateByCollector🔗

Description: The aggregate rate metrics structure represents a set of aggregated collector data flow rate metrics

Fields🔗

Field Type Description Arguments
aggregateRate PromMatrix Selecting this field yields the rough equivalent of: sum(rate(collector_conversation_bytes[TimeRange]))[TimeRange]

ClusterNodeTimeSeries🔗

Fields🔗

Field Type Description Arguments
clusterID String
tenant String
nodeId String
nodeName String
ipAddress String
val TimeSeries

TimeSeries🔗

Fields🔗

Field Type Description Arguments
time String
unixTime Int
value String

FlowRate🔗

Description: The aggregate flow rate metrics structure represents a set of collector data flow rate metrics. Note that if custom host->address mappings, as returned by getHosts, are found they will be included or updated in the src_dns field.

Fields🔗

Field Type Description Arguments
perFlowMax PromVector Selecting this field yields the rough equivalent of: max(collector_last_seen) by (src_host,dst_host,dst_port,host_addr,src_dns,proto)
perFlowAverage PromVector Selecting this field yields the rough equivalent of: avg(rate(collector_conversation_bytes[TimeRange])) by (src_host,dst_host,dst_port,host_addr,src_dns,proto)

LogLastSeenMetrics🔗

Description: LogLastSeenMetrics holds log health data for all recorded log sources for a given collector

Fields🔗

Field Type Description Arguments
logMetrics LogLastSeenMetric

DataSourceMetrics🔗

Description: DataSourceMetrics holds log health data for all recorded log sources for a given collector

Fields🔗

Field Type Description Arguments
metrics DataSourceMetric

LogLastSeenMetric🔗

Description: LogLastSeenMetric contains all of the relevant metadata to identify a log source as well as a 'lastSeen' timestamp which stores the last time that this log source was seen. A health status is also determined based on the recent ingest rate from this log source and how it compares to its historical ingest rate. 1 standard deviation away from the historical average is considered to be 'HEALTHY'. Anything greater than 1 but less than 2 standard deviations away is considered 'DEGRADED'. Anything greater than 2 standard deviations is considered 'UNHEALTHY'. If a health status cannot be determined due to an error or insufficient data then the returned health status will be 'UNKNOWN'.

Fields🔗

Field Type Description Arguments
clusterID ID
clusterName String
sourceID String
aliases String
service String
sensorType String
lastSeen Time
health String

DataSourceMetric🔗

Description: DataSourceMetric contains all of the relevant metadata to identify a log source as well as a 'lastSeen' timestamp which stores the last time that this log source was seen. A health status is also determined based on the recent ingest rate from this log source and how it compares to its historical ingest rate. 1 standard deviation away from the historical average is considered to be 'HEALTHY'. Anything greater than 1 but less than 2 standard deviations away is considered 'DEGRADED'. Anything greater than 2 standard deviations is considered 'UNHEALTHY'. If a health status cannot be determined due to an error or insufficient data then the returned health status will be 'UNKNOWN'.

Fields🔗

Field Type Description Arguments
clusterID ID
clusterName String
sourceID String
aliases String
service String
sensorTypes String
lastSeen Time
health String

SyslogMessageCountV2🔗

Fields🔗

Field Type Description Arguments
sourceID String
schema String
sensorTypes String
services String
collectors String
count Uint

AWSDetails🔗

Description: The awsDetails input type contains the necessary identifying information for use with an AWS image download. Deprecated, use AWSDetailsV2 with getClusterImageV2.

Fields🔗

Field Type Description Arguments
accountID ID
region String

AWSDetailsV2🔗

Description: The awsDetails input type contains the necessary identifying information for use with an AWS image download. It is the strongly typed counterpart to AWSDetails.

Fields🔗

Field Type Description Arguments
accountID Uint
region String

GCPDetails🔗

Description: The gcpDetails input type contains the necessary identifying information for use with a GCP image download. Deprecated, use GCPDetailsV2 with getClusterImageV2.

Fields🔗

Field Type Description Arguments
agentId String
cidr String
gcpProject String
network String
region String
subnet String
zone String

GCPDetailsV2🔗

Description: The gcpDetails input type contains the necessary identifying information for use with a GCP image download. It is the strongly typed counterpart to GCPDetails.

Fields🔗

Field Type Description Arguments
agentId EmailAddress
cidr NetworkCIDR
gcpProject String
network String
region String
subnet String
zone String

GetDataSourceMetricsArguments🔗

Description: GetDataSourceMetricsArguments allows specifying filter arguments when calling GetDataSourceMetrics If no filters are specified, this will return all log sources metrics for all existing clusters and sources

Fields🔗

Field Type Description Arguments
clusterId ID
sourceId ID

SyslogMessageCountV2Arguments🔗

Fields🔗

Field Type Description Arguments
sourceId ID
clusterId ID

TimeRange🔗

Description: TimeRange holds the available time range enums accepted by the prometheus query endpoints

ClusterType🔗

Description: ClusterType holds the available cluster type enums meant to represent whether a cluster is on prem or cloud hosted

ImageType🔗

Description: ImageType holds the available and supported collector image type enums

DataCollector🔗

Description: Datacollector structure represents the attributes of a data collector that can be used in custom widgets in CQL Query

Fields🔗

Field Type Description Arguments
id ID
name String
type String
nodes NodeInfo
applications Deployment
collectorHealth String
isHa Boolean
tenant ID

NodeInfo🔗

Fields🔗

Field Type Description Arguments
network Network
nodeHealth String

DataCollectorResult🔗

Fields🔗

Field Type Description Arguments
dataCollectors DataCollector
aggregation Map
pagination QLPageCursor Only available for search queries, describes pagination information from the assets result set

QlQueryInput🔗

Fields🔗

Field Type Description Arguments
cqlQuery String
cursor String Only for search queries. The cursor representing the page to return a base64 encoded '{offset} {count}' template. Normally you will get this value from a previous request. (previousCursor, nextCursor)
count Int How many records after the cursor (positive number) or before (negative number) should be returned, this allows setting the page size, or change it if needed. This only applies for search queries

QLPageCursor🔗

Description: QLPageCursor describes cursor information that can be used for navigating the results on a per page fashion. It will indicate more results by returning optionally returning previousCursor and nextCursor. This object also returns the total count and the current page count, to ease logic in the UI.

Fields🔗

Field Type Description Arguments
nextCursor String Cursor for the next page, if any. Will be null when we are at the end of the result set
previousCursor String Cursor for the previous page, if any. Will be null when we are at beginning of the result set
cursor String The cursor for the current page.
count Int How many records are being returned on this page
totalCount Int How many records are available for the given search criteria