Browse the extensions reference

reportShares

returns ReportShareList

Where this graph's reports have been shared: each recipient graph, when, by whom, how many facts it received, and whether the share was revoked.

The sender's record behind share-report and revoke-report-share. Revoked shares are history: a recipient shared to, revoked, and shared to again has two rows, one revoked and one live.

Arguments

NameTypeDescription
reportIdStringOne report's shares. Omit for the graph's whole distribution log.
includeRevokedBoolean! = falseAlso list revoked shares. Off by default, so the list is the copies recipients still hold.
limitIntMaximum rows to return, 1-1000. Omit to use this field's own default; out of range raises INVALID_PAGINATION.
offsetIntRows to skip before returning, 0 or greater. Out of range raises INVALID_PAGINATION.

Returns ReportShareList

Paginated list of a report's shares, newest first.

FieldTypeDescription
reportShares[ReportShare!]!Shares, newest first.
paginationPaginationInfo!Pagination metadata.

Example

query
{ reportShares(includeRevoked: true) }
curl
curl -X POST "https://api.robosystems.ai/extensions/$GRAPH_ID/graphql" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ reportShares(includeRevoked: true) }"}'