API Reference
Assets Queries
node
Parameters
-
ID!
Possible Return Values
-
Asset
Describes an Asset in Red Cloak TDR. -
EndpointGroup
Describes the endpoint group information of a Taegis agent asset.
assetsByTag
Get a list of assets with tagParameters
-
[String!]!
Return Value
-
[Asset!]!
Get a list of assets with tag
allUniqueTags
Get a list of all unique tagsParameters
- No parameters.
Return Value
-
[String!]!
Get a list of all unique tags
assetEndpointInfo
Get RedCloak endpoint info by idParameters
-
ID!
Return Value
-
EndpointInfo!
Get RedCloak endpoint info by id
assetEndpointInfoV2
Get RedCloak endpoint info by id with TDR module healthParameters
-
ID!
Return Value
-
EndpointInfo!
Get RedCloak endpoint info by id with TDR module health
allAssets
Get a list of assetsParameters
-
Int
-
Int
-
AssetsOrderByInput
-
AssetsOrderDirectionInput
-
AssetStateFilter
-
Boolean
Return Value
-
AssetsResult
Get a list of assets
allAssetsExport
Get a list of assets for export to CSVParameters
-
Int
-
Int
Return Value
-
AssetsResult
Get a list of assets for export to CSV
assetCount
Count of assets of a specific endpoint_typeParameters
Return Value
-
AssetCounts!
Count of assets of a specific endpoint_type
assetCountGroupByEndpointType
Count of assets of grouped by endpoint_typeParameters
- No parameters.
Return Value
-
[AssetCountsByEndpointType!]!
Count of assets of grouped by endpoint_type
allAssetsCount
Count of all assetsParameters
- No parameters.
Return Value
-
AssetCounts!
Count of all assets
assetsByHostIds
Bulk lookup by hostIdsParameters
-
[String!]
Return Value
-
[Asset!]!
Bulk lookup by hostIds
assetsByIpAddresses
Bulk lookup by ipAddressParameters
-
[String!]
Return Value
-
[Asset!]!
Bulk lookup by ipAddress
allAssetHistories
Get a list of asset histories for the tenantParameters
-
Int
-
Int
Return Value
-
[AssetHistory!]!
Get a list of asset histories for the tenant
assetRedCloakHistories
Get history of actions on an asset by id (includes RedCloack history)Parameters
-
ID!
-
Int
-
Int
Return Value
-
[AssetRedCloakHistory!]!
Get history of actions on an asset by id (includes RedCloack history)
searchAssets
search assets. Soon to be deprecatedParameters
-
Int
-
Int
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
Boolean
-
Boolean
-
AssetsOrderByInput
-
AssetsOrderDirectionInput
-
Boolean
-
AssetStateFilter
Return Value
-
AssetsResult
search assets. Soon to be deprecated
exportSearchAssets
export search assets resultsParameters
Return Value
-
AssetsExportOutput
export search assets results
facetInfo
get facet info based on a currently selected facetParameters
Return Value
-
[FacetInfo]!
get facet info based on a currently selected facet
Assets Mutations
isolateAsset
Isolate an asset by idParameters
-
ID!
-
String!
Return Value
-
Asset!
Isolate an asset by id
integrateAsset
Integate an asset by idParameters
-
ID!
-
String!
Return Value
-
Asset!
Integate an asset by id
deleteAssets
Delete or un-delete assetParameters
-
[ID!]!
-
Boolean
Return Value
-
Boolean
Delete or un-delete asset
createAssetTag
Create a new tag for an assetiParameters
-
String!
-
String!
Return Value
-
Tag!
Create a new tag for an asseti
updateAssetTag
Updates a tag for an assetParameters
-
ID!
-
String!
Return Value
-
Tag!
Updates a tag for an asset
deleteAssetTag
Deletes a tag for an assetParameters
-
ID!
Return Value
-
Tag
Deletes a tag for an asset
addInvestigationAssets
add investigation assets relation for the list of host_ids and return the asset idsParameters
-
[String]
-
[String]
-
String!
Return Value
-
[Asset!]!
add investigation assets relation for the list of host_ids and return the asset ids
removeInvestigationAssets
remove investigation assets relationParameters
-
[String!]
-
String!
Return Value
-
Boolean!
remove investigation assets relation
Asset
Describes an Asset in Red Cloak TDR.
Fields
-
ID!
-
String!
-
String!
-
String!
-
String!
-
String!
-
Time!
-
Time!
-
Time!
-
Time
-
String
-
String
-
String
-
String
-
String
-
String
-
[Hostname!]!
-
[EthernetAddress!]!
-
[IpAddress!]!
-
[User!]!
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
[Tag!]!
-
String
-
String
-
String
-
String
-
EndpointGroup
AssetCountsByEndpointType
Fields
-
String!
-
Int!
AssetHistory
Describes the history of an asset.
AssetRedCloakHistory
Describes the Red Cloak agent history of an asset.
Fields
-
String
-
[String]
-
String
-
AssetHistoryContact
-
String
-
AssetHistoryEvent
-
AssetHistoryId
-
String
-
String
Assets
Fields
-
Int!
-
[Asset]!
-
PartialPageInfo
AssetsExportOutput
Fields
-
[String!]!
-
[[String!]!]!
-
Int
AssetsResult
Describes the return type of the <code>AllAssets</code> and <code>SearchAssets</code> queries.
Fields
-
Int!
-
Int!
-
Int!
-
[Asset!]!
EndpointInfo
Describes the endpoint information of a Red Cloak agent asset.
Fields
-
Boolean
-
[String]
-
String
-
Boolean
-
String
-
String
-
String
-
IgnitionDetails
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
[ModuleHealth]
-
[ModuleStatus]
-
Int
-
Int
-
SystemInformation
-
[ModuleHealthV2]
Facet
Fields
-
String!
-
String!
-
Boolean!
FacetFieldInfo
Fields
-
String!
-
Int
FacetInfo
Fields
-
String!
-
[FacetFieldInfo]!
ModuleHealth
Describes the ModuleHealth of a Red Cloak agent asset.
Fields
-
String
-
String
-
String
-
String
-
String
ModuleHealthV2
Describes the module event processing time of a Red Cloak agent asset on TDR.
Fields
-
Time
-
String
PartialPageInfo
Fields
-
String
-
Boolean!
SystemInformation
Describes the system information of a Red Cloak agent asset.
Fields
-
String
-
String
-
[String]
-
String
-
String
-
[String]
-
Boolean
-
String
-
Int
-
String
-
String
-
String
AssetWhereInput
Fields
-
[AssetWhereInput]
-
[AssetWhereInput]
-
AssetWhereInput
-
ID
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
AssetsArguments
Fields
-
Int
-
String
-
AssetWhereInput!
-
AssetSearchOrderByInput
-
EndpointType
FacetInfoArguments
Fields
-
[String!]!
the facet to retrieve info about -
EndpointType
-
FacetInfoOrderByInput
-
AssetWhereInput!
FacetsArguments
Fields
SearchAssetsInput
Fields
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
Boolean
-
Boolean
-
Boolean
-
AssetStateFilter
-
String
AssetSearchOrderByInput
Possible Values
AssetStateFilter
Possible Values
AssetsOrderByInput
Describes the enums available for the ordering of the <code>AllAssets</code> and <code>SearchAssets</code> queries.
Possible Values
AssetsOrderDirectionInput
Describes the order direction available for the order field of the <code>AllAssets</code> and <code>SearchAssets</code> queries.
Possible Values
EndpointType
Possible Values
FacetInfoOrderByInput
Possible Values
Time
Default time implementation for this library.
Audits Queries
ListApplicationEvents
Get event name listParameters
Return Value
-
AuditEventResult
Get event name list
Audit
Defines the fields of an Audit log
Fields
-
ID!
-
String!
-
String!
-
String!
-
String!
-
String!
-
Map
-
String!
-
String
-
String!
-
Time
-
String!
-
String!
-
String
-
ID
-
MetadataMap
-
Int!
-
String!
-
HeaderMap
-
RequestParamMap
-
Map
-
Map
-
Map
AuditEventResult
AuditEventResult represents a list of AuditEvents along with metadata like total events
Fields
-
Int!
-
[AuditEvent!]!
AuditResult
AuditResult represents a list of Audit logs along with metadata for pagination and relation
Fields
-
Int!
-
String!
-
Int!
-
Int!
-
[Audit!]!
AllAuditsInput
Defines the fields for retrieving paginated Audit logs
AuditInput
Internal use only - Defines the fields of an audit log
Fields
-
String!
-
String!
-
String!
-
String
-
String
-
String
-
Map
-
String!
-
String
-
String!
-
String
-
Int!
-
String
-
ID
-
MetadataMap
-
Int!
-
String!
-
HeaderMap
-
RequestParamMap
-
Map
-
Map
-
Map
AuditSearchInput
Defines the fields used for searching Audit logs along with pagination input like offset and limit
SortBy
Possible Values
SortOrder
Possible Values
Time
Default time implementation for this library.
Clients Queries
clients
Search ClientsParameters
-
String
Client name to filter for. This will use SQL 'like' matching -
[String]
Filters for client_ids, will use the SQL 'in' filter -
ID
Filter clients by tenant ID. This is useful only for scwx* role requesters. Tenant requesters will automatically have results filtered for their tenants -
[ID]
Role IDs assigned to users -
[ID]
Tenant IDs associated with role assignments -
Int
Pagination start page, page 1 is the beginning -
Int
Pagination page size. Page size of -1 (default) indicates no pagination
Return Value
-
[Client!]!
Search Clients
Clients Mutations
createClient
Create a new client (SCWX (tenant 5000) clients are disallowed)Parameters
-
String!
Return Value
-
NewClient
Create a new client (SCWX (tenant 5000) clients are disallowed)
rotateClientSecret
Generate a new secret for an existing clientParameters
-
ID!
Return Value
-
NewClient
Generate a new secret for an existing client
Client
Fields
-
ID!
-
String!
-
String!
-
String!
-
[ClientRoleAssignment]
-
ID!
-
Time!
-
Time!
-
String!
ClientRoleAssignment
Fields
-
ID!
-
ID!
-
ID!
-
String
ClientsAuthzAction
Possible Values
ClientsAuthzObject
Possible Values
ClientsGraphQLQueryType
Possible Values
Connectors Queries
node
Parameters
-
ID!
Possible Return Values
-
ConnectorCategory
ConnectorCategory is a grouping/categorization of available connectors (e.g. IP reputation services, DNS lookup, etc) -
ConnectorAction
ConnectorAction declares a method or activity that can be called on a connector and its corresponding input and output -
ConnectionMethod
ConnectionMethod references a service that implements connectors of a specific connection method (e.g. http, grpc, graphql) -
Connector
Connector is an entry in catalog of available connectors (e.g. service now connector based on generic http connector service) -
ConnectorVersion
ConnectorVersion contains the versioned attributes of a connector interface -
DeletedObject
-
Connection
Connection is a per-tenant configuration of a connector/actions
Connectors Mutations
defineConnectionMethod
Define new connection methodParameters
Return Value
-
ConnectionMethod
Define new connection method
removeConnectionMethod
Remove connection methodParameters
-
ID!
Return Value
-
ConnectionMethod
Remove connection method
updateConnector
Update connector definitionParameters
Return Value
-
Connector
Update connector definition
createConnectorVersion
Creates a new connector version in draft modeParameters
Return Value
-
ConnectorVersion
Creates a new connector version in draft mode
updateConnectorVersion
Update an existing draft connector versionParameters
Return Value
-
ConnectorVersion
Update an existing draft connector version
publishConnectorVersion
Publishing a connector version makes it immutable and sets it as current headParameters
Return Value
-
ConnectorVersion
Publishing a connector version makes it immutable and sets it as current head
deleteConnectorVersion
Deleting a connector version is not supported after a version is publishedParameters
Return Value
-
ConnectorVersion
Deleting a connector version is not supported after a version is published
createConnection
Create new connectionParameters
-
ID!
-
ConnectionInput!
Return Value
-
Connection
Create new connection
updateConnection
Update connectionParameters
-
ID!
-
ConnectionInput!
Return Value
-
Connection
Update connection
validateConnection
Validate an existing connectionParameters
-
ID!
Return Value
-
Connection
Validate an existing connection
validateConnectionInput
Validate new connectionParameters
-
ID!
-
ConnectionInput!
Return Value
-
Connector
Validate new connection
executeConnectionAction
Execute an actionParameters
-
ID!
-
String!
-
Any
Return Value
-
Any
Execute an action
executeConnectorAction
Execute a connector actionParameters
-
String!
-
Any
Return Value
-
Any
Execute a connector action
Connectors Subscriptions
Connection
Connection is a per-tenant configuration of a connector/actions
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
String
-
Connector!
-
ConnectorVersion
-
SemVer!
-
ConnectionVersionStrategy
-
[String!]
-
AuthType!
-
String
-
JSONObject
-
JSONObject
-
Int
-
ConnectionRateLimit
ConnectionMethod
ConnectionMethod references a service that implements connectors of a specific connection method (e.g. http, grpc, graphql)
Fields
-
ID!
-
Time!
-
Time!
-
String!
-
String
-
JSONSchema
-
String!
-
[Connector!]
ConnectionRateLimit
Fields
-
String
-
Int
Connector
Connector is an entry in catalog of available connectors (e.g. service now connector based on generic http connector service)
Fields
-
ID!
-
String!
-
Time!
-
String!
-
Time!
-
String!
-
Int
-
String
-
String
-
[String!]
-
[ConnectorCategory!]!
-
[Connection!]
-
ConnectionMethod!
-
ConnectorVersion!
-
[ConnectorVersion!]!
ConnectorAction
ConnectorAction declares a method or activity that can be called on a connector and its corresponding input and output
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
ConnectorVersion
-
String
-
JSONSchema
-
JSONSchema
-
JSONObject
ConnectorCategory
ConnectorCategory is a grouping/categorization of available connectors (e.g. IP reputation services, DNS lookup, etc)
ConnectorExport
Fields
-
String!
ConnectorRateLimit
Fields
-
String
-
Int
-
String
-
Int
-
String
-
Int
ConnectorVersion
ConnectorVersion contains the versioned attributes of a connector interface
Fields
-
ID!
-
SemVer
-
Time!
-
String!
-
Time!
-
String!
-
Time
-
String
-
Connector!
-
String!
-
String
-
String
-
String
-
String
-
String
-
JSONObject
-
[Connection!]
-
JSONSchema
-
[ConnectorAction!]!
-
[AuthType!]!
-
ConnectorAction
-
ConnectorAction
-
String
-
String
-
String
-
ConnectorRateLimit
CloneConnectorInput
Fields
-
String!
-
ID!
-
ID!
ConnectionAPIKeyAuth
Fields
-
String!
-
String!
-
String!
ConnectionBasicAuth
Fields
-
String!
-
String!
ConnectionClientCertificateAuth
Fields
-
String!
-
String!
-
String
ConnectionCredentialsInput
Fields
-
ConnectionRawAuth
-
ConnectionBasicAuth
-
ConnectionAPIKeyAuth
-
ConnectionOAuth2ClientCredsAuth
-
ConnectionClientCertificateAuth
-
ConnectionOAuth2PasswordCredsAuth
-
ConnectionOAuth2AuthCodeAuth
ConnectionInput
ConnectionInput defines the mutable fields of a connection
Fields
-
String!
-
String
-
Tags
-
JSONObject
-
JSONObject
-
AuthType
-
String
-
ID
-
ConnectionVersionStrategy
-
SemVer
-
ConnectionRateLimitInput
ConnectionMethodInput
ConnectionMethodInput defines the fields required to register a new connection method
Fields
-
String!
-
String
-
String!
-
JSONSchema
-
Tags
ConnectionOAuth2AuthCodeAuth
Fields
-
String!
-
String!
-
[String!]
-
String!
ConnectionOAuth2ClientCredsAuth
Fields
-
String!
-
String!
-
[String!]
ConnectionOAuth2PasswordCredsAuth
Fields
-
String!
-
String!
-
[String!]
-
String!
-
String!
ConnectionRateLimitInput
Fields
-
String!
-
Int!
ConnectionRawAuth
Fields
-
String!
ConnectorActionInput
ConnectorActionInput defines the mutable fields of a connector action declaration
Fields
-
String!
-
String
-
JSONSchema
-
JSONSchema
-
JSONObject
ConnectorCategoriesArguments
ConnectorCategoriesArguments defines the filters and options for listing connectorCategories
Fields
-
[String!]
-
IDs
ConnectorExportArguments
Fields
-
ID
-
String
ConnectorRateLimitInput
Fields
-
String!
-
Int!
-
String!
-
Int!
-
String!
-
Int!
ConnectorVersionArguments
ConnectorVersionArguments defines the filters and options for listing connectorVersions
Fields
-
String
-
ID
ConnectorVersionsArguments
ConnectorVersionsArguments defines the filters and options for listing connectorVersions
Fields
-
[String!]
-
IDs
CreateConnectorInput
ConnectorInput defines the fields required to create a connector
CreateConnectorVersionInput
CreateConnectorVersionInput defines the versioned fields of a connector
Fields
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
JSONObject
-
JSONSchema
-
[ConnectorActionInput!]
-
[AuthType!]!
-
SemVer
-
ConnectorRateLimitInput
DeleteConnectorInput
DeleteConnectorInput defines the mutable metadata fields of a connector
Fields
-
ID!
ImportConnectorInput
Fields
TestConnectorActionInput
Fields
-
ConnectionInput!
-
String!
-
ConnectorActionInput!
-
Any
UpdateConnectorInput
UpdateConnectorInput defines the mutable metadata fields of a connector
UpdateConnectorVersionInput
UpdateConnectorVersionInput defines the versioned fields of a connector
Fields
-
ID!
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
JSONObject
-
JSONSchema
-
[ConnectorActionInput!]
-
[AuthType!]
-
SemVer
-
ConnectorRateLimitInput
ConnectionVersionStrategy
ConnectionVersionStrategy determines how the connection is upgraded when new versions are published
Possible Values
IDs
list of IDs
JSONObject
JSON payload
JSONSchema
JSON Schema
SemVer
version string in semver format
Tags
list of tags
Time
Time implementation for this library.
Node
Fields
-
ID!
Events Queries
eventQuery
Returns query status by IDParameters
-
ID!
Return Value
-
EventQuery
Returns query status by ID
eventQueries
Provides a catalog of cached queriesParameters
Return Value
-
[EventQuery!]!
Provides a catalog of cached queries
Events Mutations
Events Subscriptions
eventPage
Returns the next logical page of results for each of the event types covered by the queryParameters
-
ID!
Return Value
-
EventQueryResults!
Returns the next logical page of results for each of the event types covered by the query
eventQuery
Evaluates a query string and returns results for the first page of each event type covered by the queryParameters
-
String!
-
JSONObject
-
EventQueryOptions
Return Value
-
EventQueryResults!
Evaluates a query string and returns results for the first page of each event type covered by the query
Event
Fields
-
ID!
-
JSONObject
EventQuery
EventQuery defines the overall query status and metadata
Fields
-
ID!
-
String!
-
String!
-
[EventQueryResult!]
-
Time!
-
Time!
-
Time
-
Time
-
Time
-
[String!]
-
JSONObject
-
EventUser
-
[EventQueryProgress!]
EventQueryProgress
EventQueryProgress provides basic metrics about query progress
Fields
-
String
The event type -
Int
The total rows available as the result of the search. For the Athena backend this is always the same as the maxRowsPerQuery, for Arcana it is the total rows that matched the search criteria (but could be capped for other reasons) -
Boolean
Flag that indicates whether or not the total rows is actually a lower bound (e.g. the actual number of results count be higher). Indicates that we have *atLeast* TotalRows that match the search query -
Boolean
Flag that indicates whether the results were truncated (there are more results available but we only returned a portion of them)
EventQueryResult
EventQueryResult returns query status and if available a page of results for a specific event type
Fields
-
ID!
-
String!
-
String!
-
String!
-
String
-
Time!
-
Time
-
Time
-
JSONObject
-
[JSONObject]
-
EventQueryProgress
EventQueryResults
EventQueryResults contains overall query status and optionally results for a specific event type
Fields
-
EventQuery!
-
EventQueryResult
-
ID
if present points to the next logical page of results across all event types covered by the query -
ID
if present points to the prev page of results
EventQueryOptions
EventQueryOptions provides ability to override default query behavior
Fields
-
Boolean
reverses default timestamp order of descending -
Int
change default page size up to 1K max -
Int
change default number of rows requested up to 100K max -
Boolean
dont use cached results -
Boolean
disable aggregation operations
JSONObject
JSON payload
Time
Time implementation for this library.
Investigations Queries
node
Parameters
-
ID!
Possible Return Values
-
Event
Used by Nautilus to resolve the Red Cloak TDR event model. -
Alert
Used by Nautilus to resolve the Red Cloak TDR alert model. -
Alert2
Used by Nautilus to resolve the Red Cloak TDR alertv2 model. -
Asset
Used by Nautilus to resolve the Red Cloak TDR asset model. -
TDRUser
Used by Nautilus to resolve the Red Cloak TDR user model. -
Investigation
Describes a Red Cloak TDR investigation.
investigationSummary
Get summary of investigations (tag and counts for each tag)Parameters
- No parameters.
Return Value
-
[InvestigationSummary!]!
Get summary of investigations (tag and counts for each tag)
investigation
Get an investigation by idParameters
-
ID!
Return Value
-
Investigation
Get an investigation by id
investigations
Get investigations for the list of idsParameters
-
[ID!]
Return Value
-
[Investigation!]!
Get investigations for the list of ids
allInvestigations
Get all investigationsParameters
-
[String]
-
Int
-
Int
-
String
-
String
-
String
-
String
-
OrderFieldInput
-
OrderDirectionInput
-
Boolean
-
Boolean
Return Value
-
[Investigation!]!
Get all investigations
investigationCountOverTime
Get the number of investigations created during a given time frame. Can optionslly pass in a desired 'transition_status' (handoff, acknowledge, resolution)Return Value
-
Count!
Get the number of investigations created during a given time frame. Can optionslly pass in a desired 'transition_status' (handoff, acknowledge, resolution)
meanTimeSummaryOverPeriod
Get the average times it took to hand off, acknowledge, and resolve all investigations over the course of the periodReturn Value
-
TimeSummaryForGroup!
Get the average times it took to hand off, acknowledge, and resolve all investigations over the course of the period
investigationAssets
Get investigation assets by investigation idParameters
-
ID!
-
Int
-
Int
Return Value
-
InvestigationAssetOutput!
Get investigation assets by investigation id
investigationEvents
Get investigation events by investigation idParameters
-
ID!
-
Int
-
Int
Return Value
-
InvestigationEventOutput!
Get investigation events by investigation id
investigationAlerts
Get investigation alerts by investigation idParameters
-
ID!
-
Int
-
Int
-
String
-
String
-
OrderDirection
Return Value
-
InvestigationAlertOutput!
Get investigation alerts by investigation id
investigationGenesisEvents
Get investigation genesis events by investigation idParameters
-
ID!
Return Value
-
[Event!]!
Get investigation genesis events by investigation id
investigationGenesisAlerts
Get investigation genesis alerts by investigation idParameters
-
ID!
Return Value
-
[Alert!]!
Get investigation genesis alerts by investigation id
investigationAuthCredentials
Get investigation auth credentials by investigation idParameters
-
ID!
Return Value
-
[String!]!
Get investigation auth credentials by investigation id
investigationSearchQueries
Get investigation search queries by investigation idParameters
-
ID!
Return Value
-
[SearchQuery!]!
Get investigation search queries by investigation id
investigationsBulkEventsAlerts
Get investigations by quering a string on events/alerts/genesis events/genesis alerts fieldsParameters
-
[String!]!
Return Value
-
[InvestigationBulkResponse!]!
Get investigations by quering a string on events/alerts/genesis events/genesis alerts fields
investigationsBulkUpdateAlerts
Updates Investigation Alerts and Investigation information from Alerts (ie Access Vectors)Parameters
- No parameters.
Return Value
-
String
Updates Investigation Alerts and Investigation information from Alerts (ie Access Vectors)
investigationStatusSummary
Get summary of investigations and status filtered by updated_atParameters
-
String
-
String
Return Value
-
[SummaryGroup!]!
Get summary of investigations and status filtered by updated_at
investigationsSearch
Investigations Search. query fields accepts CQL string (non aggregations). Use filterText for free text searchParameters
-
Int
-
Int
-
String
-
String
-
OrderFieldInput
-
OrderDirectionInput
Return Value
-
InvestigationsOutput!
Investigations Search. query fields accepts CQL string (non aggregations). Use filterText for free text search
investigationsAdvancedSearch
Investigations Advanced Search can perform aggregations/sorting/filtering on investigations using CQLParameters
-
String!
Return Value
-
[Map!]!
Investigations Advanced Search can perform aggregations/sorting/filtering on investigations using CQL
investigationProcessingStatus
Get investigation processing status by idParameters
-
ID!
Return Value
-
InvestigationProcessingResponse
Get investigation processing status by id
getFalsePositives
MDR - false positives widgetReturn Value
-
Map!
MDR - false positives widget
investigationsCount
Get aggregated investigations counts based on CQL queryParameters
-
String
Return Value
-
Int!
Get aggregated investigations counts based on CQL query
investigationsStatusCount
Get aggregated investigations status countsParameters
- No parameters.
Return Value
-
InvestigationStatusCountResponse!
Get aggregated investigations status counts
exportInvestigationsSearch
Export investigations Search Raw ContentParameters
-
Int
-
Int
-
String
-
String
-
OrderFieldInput
-
OrderDirectionInput
Return Value
-
InvestigationsExportOutput!
Export investigations Search Raw Content
investigationFile
Get investigation file detailsParameters
-
ID!
Return Value
-
InvestigationFile!
Get investigation file details
investigationFiles
Get investigation files detailsParameters
-
ID!
Return Value
-
[InvestigationFile!]!
Get investigation files details
downloadInvestigationFile
Presigned URK to Download investigation fileParameters
-
ID!
-
ID!
Return Value
-
String!
Presigned URK to Download investigation file
investigationsBySession
Get investigations by multi-tenant sessionParameters
-
String!
-
Int
-
Int
Return Value
-
[Investigation]
Get investigations by multi-tenant session
getHandoffInvestigations
Return list of Investigations which are handed off atleast once for the the given dates and statusParameters
-
Int
-
Int
-
String
-
String
-
Boolean
-
Boolean
Return Value
-
InvestigationsOutput!
Return list of Investigations which are handed off atleast once for the the given dates and status
investigationTypes
Return investigation types list based on userParameters
- No parameters.
Return Value
-
[InvestigationKeyValuePair!]!
Return investigation types list based on user
investigationStatusList
Return investigation status static listParameters
- No parameters.
Return Value
-
[InvestigationKeyValuePair!]!
Return investigation status static list
investigationPriorityList
Return investigation priority static listParameters
- No parameters.
Return Value
-
[InvestigationKeyValuePair!]!
Return investigation priority static list
Investigations Mutations
createInvestigation
Create new investigationParameters
Return Value
-
Investigation
Create new investigation
archiveInvestigation
Archive investigationParameters
-
ID!
Return Value
-
Investigation
Archive investigation
bulkArchiveInvestigations
Bulk Archive InvestigationsParameters
-
[ID!]!
Return Value
-
[ID!]
Bulk Archive Investigations
unArchiveInvestigation
UnArchive InvestigationParameters
-
ID!
Return Value
-
Investigation
UnArchive Investigation
bulkUnArchiveInvestigations
Bulk UnArchive InvestigationsParameters
-
[ID!]!
Return Value
-
[ID!]
Bulk UnArchive Investigations
createActivityLogForInvestigation
Create a new activity log for investigationParameters
Return Value
-
ActivityLog
Create a new activity log for investigation
addAssetsToInvestigation
Add assets to investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Add assets to investigation
addEventsToInvestigation
Add events to investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Add events to investigation
addAlertsToInvestigation
Add alerts to investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Add alerts to investigation
addGenesisEventsToInvestigation
Add genesis events to investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Add genesis events to investigation
addGenesisAlertsToInvestigation
Add genesis alerts to investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Add genesis alerts to investigation
addAuthCredentialsToInvestigation
Add auth credentials to investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Add auth credentials to investigation
addSearchQueriesToInvestigation
Add search queries to investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Add search queries to investigation
addAccessVector
Access VectorsReturn Value
-
AccessVector!
Access Vectors
removeAssetsFromInvestigation
Remove assets from investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Remove assets from investigation
removeEventsFromInvestigation
Remove events from investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Remove events from investigation
removeAlertsFromInvestigation
Remove alerts from investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Remove alerts from investigation
removeSearchQueriesFromInvestigation
Remove search queries from investigationParameters
-
ID!
-
[String!]!
Return Value
-
Investigation
Remove search queries from investigation
addBulkAlertsToInvestigation
Bulk add alerts to an investigation using restdb search queryParameters
-
ID
-
InvestigationInput
-
String!
Return Value
-
Investigation
Bulk add alerts to an investigation using restdb search query
addBulkAlerts2ToInvestigation
Bulk add alerts2 to an new investigation using cql queryParameters
-
InvestigationInput!
-
String!
Return Value
-
Investigation
Bulk add alerts2 to an new investigation using cql query
addBulkAlerts2ToExistingInvestigation
Bulk add alerts2 to an existing investigation using cql queryParameters
-
ID!
-
String!
Return Value
-
Investigation
Bulk add alerts2 to an existing investigation using cql query
reProcessInvestigationBackgroundJob
Reprocess investigation background job by idParameters
-
ID!
Return Value
-
InvestigationProcessingResponse
Reprocess investigation background job by id
deleteInvestigation
Hard delete of investigation (Supported only in development environments)Parameters
-
ID!
Return Value
-
ID!
Hard delete of investigation (Supported only in development environments)
acknowledgeInvestigation
Update state_transitions table to acknowledge if current state is handoff, without changing the investigation itselfParameters
-
ID!
Return Value
-
ID!
Update state_transitions table to acknowledge if current state is handoff, without changing the investigation itself
fileUpload
Upload File for an investigationParameters
Return Value
-
InvestigationFile!
Upload File for an investigation
deleteFile
Delete investigation files from S3 bucketParameters
-
ID!
-
ID!
Return Value
-
Boolean!
Delete investigation files from S3 bucket
AccessVector
Fields
-
ID!
-
ID!
-
String!
-
Time!
-
Time!
-
MitreAttackInfo
ActivityLog
Stores details of an investigation activity (Create/Update, etc.).
AlertData
Describes a Red Cloak TDR alert.
Fields
-
String!
-
String!
-
Timestamp
-
Timestamp
-
String!
-
Int!
-
String!
-
Int!
-
[String!]!
-
[MitreAttackInfo]
-
String!
-
String!
-
String!
-
String!
-
String!
-
String!
AlertSourceData
Contains the source information for an alert.
Fields
-
String!
-
String!
-
String!
-
String!
IndividualTimeSummary
Represents the amounts of time it took before an investigation transitioned into the handoff, acknowledge, and resolution states.
Fields
-
Int
-
Int
-
Int
-
Boolean!
-
Investigation!
Investigation
Describes a Red Cloak TDR investigation.
Fields
-
ID!
-
String!
-
[String!]!
-
[Alert!]!
-
[Alert2!]
-
[Event!]!
-
[Alert!]!
-
[Alert2!]
-
[Event!]!
-
[Asset!]!
-
[SearchQuery!]!
-
[String!]!
-
String!
-
String!
-
Time!
-
Time!
-
Time
-
[ActivityLog!]!
-
String
-
TDRUser
Retrieves the `TDRUser` object for the user that created the investigation. -
String!
-
[String!]!
-
String
-
String
-
String
-
TDRUser
Retrieves the `TDRUser` object for the user that is assigned to the investigation. -
Assignee
-
String!
-
[AccessVector!]
-
TransitionState
-
Time
-
Time
-
Boolean!
-
String
-
InvestigationProcessingResponse
-
Int
-
String
-
Int
-
Int
-
Int
-
Int
-
Int
-
Int
-
ParentCount
InvestigationAssetOutput
Fields
-
[Asset!]!
-
Int
InvestigationBulkResponse
Used to return an array of investigations for a specific query.
Fields
-
String!
-
[Investigation!]!
InvestigationEventOutput
Fields
-
[Event!]!
-
Int
InvestigationInfo
Describes a small subset of investigation information.
Fields
-
String!
-
[String!]!
-
[String!]!
-
String!
InvestigationKeyValuePair
Fields
-
String!
-
String!
-
String!
InvestigationStatusCountResponse
Fields
-
Int!
-
Int!
-
Int!
-
Int!
-
Int!
-
Int!
InvestigationsExportOutput
Fields
-
[String!]!
-
[[String!]!]!
-
Int
InvestigationsOutput
Fields
MitreAttackInfo
Describes fields related to MitreAttack information for an alert.
Fields
-
String!
-
String!
-
[String!]
-
String!
-
String!
-
[String!]!
-
[String!]!
-
String!
-
[String!]!
-
[String!]!
-
[String!]!
-
String!
ParentCount
Represents total and unread comment counts for an investigation.
Fields
-
String!
-
String!
-
Int!
-
Int!
SummaryGroup
Describes the summary of investigations by status filtered by date.
Fields
-
String!
-
Int!
-
String!
Tenant
Fields
-
ID!
-
String
TenantContextResponseState
Containes the labels and audit logs of a response .
Fields
-
String!
-
String!
-
[UserResponseState]
TenantContextResponseStateMap
Contains the context response state and name.
Fields
-
String!
-
TenantContextResponseState
TenantResponseState
Contains a source, data and labels for a tenant response.
Fields
-
String!
-
String!
-
[TenantContextResponseStateMap]
TimeSummaryForGroup
Used by MeanTimeSummaryOverPeriod query to represent the average times it took to hand off, acknowledge, and resolve all investigations over the course of the period.
Fields
-
Int!
-
Int!
-
Int!
-
[IndividualTimeSummary!]!
TransitionSummary
Used by HandedOff/Acknowledged/ResolvedInvestigations query to represent an investigations most recent transition time and time spent in each state.
Fields
UserResponseState
Contains the user information for a response.
ActivityLogInput
Describes the fields available for creating a new Activity Log.
Fields
-
String!
-
String!
-
String!
-
String!
FileUploadInput
Fields
-
ID!
-
Upload!
InvestigationInput
Describes the fields available for creating a new investigation.
Fields
-
[String!]
-
[String!]
-
[String!]
-
[String!]
-
[String!]
-
[String!]
-
[String!]
-
[String!]
-
String
-
String!
-
Time
-
String
-
String
-
[String!]
-
String
-
String
-
String
-
String
-
Int
-
String
UpdateInvestigationInput
Describes the fields available for updating an investigation.
Fields
-
[String]
-
[String]
-
[String]
-
[String]
-
[String]
-
[String]
-
[String]
-
[String]
-
String
-
String
-
Time
-
String
-
String
-
[String]
-
String
-
String
-
String
-
String
-
Boolean
-
Int
-
String
InvestigationProcessingState
Possible Values
Map
The default Map implementation for this library
OrderDirection
Possible Values
OrderDirectionInput
Describes the order direction available for the order field of the <code>AllInvestigations</code> query.
Possible Values
OrderFieldInput
Describes the enums available for the ordering of the <code>AllInvestigations</code> query.
Possible Values
Time
The default Time implementation for this library.
Uint64
`Uint64` is a custom scalar type that represents an unsigned 64 bit integer.
Upload
The default Upload implementation for this library
Playbooks Queries
node
Parameters
-
ID!
Possible Return Values
-
ConnectorCategory
ConnectorCategory is a grouping/categorization of available connectors/playbooks (e.g. IP reputation services, DNS lookup, etc) -
ConnectorInterface
ConnectorInterface defines an abstract interface (set of actions) that could be implemented by multiple connectors -
ConnectorVersion
ConnectorVersion contains the versioned attributes of a connector interface -
Connector
Connector is an entry in catalog of available connectors (e.g. service now connector based on generic http connector service) -
Connection
Connection is a per-tenant configuration of a connector/actions -
PlaybookTriggerType
PlaybookTriggerType defines an available triggering mechanism -
PlaybookTrigger
PlaybookTrigger defines a set of attributes common to different trigger types -
PlaybookInterface
PlaybookInterface defines a contract that can be implemented by one ore more playbooks -
PlaybookInterfaceVersion
PlaybookInterfaceVersion maintains a change record of the playbook interface. -
Playbook
Playbook is an entry in catalog of available playbooks -
PlaybookVersion
PlaybookVersion maintains a change record of the playbook definition. Multiple versions of a playbook could be in use concurrently -
PlaybookInstance
PlaybookInstance defines the configuration of a playbook in a user account -
PlaybookExecution
PlaybookExecution represents the state of a current playbook execution -
PlaybookExecutionLog
PlaybookExecutionLog represents a log entry from an executed playbook with it's children and status logs attached -
DeletedObject
Playbooks Mutations
clonePlaybook
Clone an existing playbookParameters
Return Value
-
Playbook
Clone an existing playbook
importPlaybookV2
Import Playbook from fileParameters
Return Value
-
Playbook
Import Playbook from file
importPlaybookResource
Import Playbook Resource from fileParameters
Return Value
-
PlaybookResource
Import Playbook Resource from file
executePlaybook
Execute playbook with supplied parametersParameters
-
ID!
-
JSONObject
Return Value
-
PlaybookExecution
Execute playbook with supplied parameters
createPlaybookVersion
Creates a new playbook version in draft modeParameters
Return Value
-
PlaybookVersion
Creates a new playbook version in draft mode
updatePlaybookVersion
Update an existing draft playbook versionParameters
Return Value
-
PlaybookVersion
Update an existing draft playbook version
publishPlaybookVersion
Publishing a playbook version makes it immutable and sets it as the current head Deleting a published playbook version is not supported"Parameters
Return Value
-
PlaybookVersion
Publishing a playbook version makes it immutable and sets it as the current head Deleting a published playbook version is not supported"
deletePlaybookVersion
Deletes the specified draft playbook versionParameters
Return Value
-
PlaybookVersion
Deletes the specified draft playbook version
createPlaybookInstance
Create new playbook instanceParameters
Return Value
-
PlaybookInstance
Create new playbook instance
updatePlaybookInstance
Update playbook instanceParameters
Return Value
-
PlaybookInstance
Update playbook instance
deletePlaybookInstance
Delete playbook instanceParameters
-
ID!
Return Value
-
PlaybookInstance
Delete playbook instance
setPlaybookInstanceState
Enabled/disable playbook instanceParameters
-
ID!
-
Boolean!
Return Value
-
PlaybookInstance
Enabled/disable playbook instance
createPlaybookExecution
Log playbook trigger / execution statusParameters
Return Value
-
PlaybookExecution
Log playbook trigger / execution status
executePlaybookInstance
Execute playbook instanceParameters
-
ID!
-
JSONObject
Return Value
-
PlaybookExecution
Execute playbook instance
playbookValidate
Validate Playbook or just the DSLParameters
Return Value
-
[PlaybookValidationError]!
Validate Playbook or just the DSL
createPlaybookInterfaceVersion
Create PlaybookInterfaceVersionParameters
Return Value
-
PlaybookInterfaceVersion
Create PlaybookInterfaceVersion
updatePlaybookInterfaceVersion
Update PlaybookInterfaceVersionParameters
Return Value
-
PlaybookInterfaceVersion
Update PlaybookInterfaceVersion
deletePlaybookInterfaceVersion
Deletes the specified playbook interface versionParameters
Return Value
-
PlaybookInterfaceVersion
Deletes the specified playbook interface version
publishPlaybookInterfaceVersion
Publish a Playbook Interface VersionParameters
Return Value
-
PlaybookInterfaceVersion
Publish a Playbook Interface Version
createPlaybookInterface
Create new playbook interfaceParameters
Return Value
-
PlaybookInterface
Create new playbook interface
updatePlaybookInterface
Update playbook interfaceParameters
Return Value
-
PlaybookInterface
Update playbook interface
deletePlaybookInterface
Delete the specified playbook interfaceParameters
Return Value
-
PlaybookInterface
Delete the specified playbook interface
Playbooks Subscriptions
Connector
Connector is an entry in catalog of available connectors (e.g. service now connector based on generic http connector service)
Fields
-
ID!
ConnectorCategory
ConnectorCategory is a grouping/categorization of available connectors/playbooks (e.g. IP reputation services, DNS lookup, etc)
Fields
-
ID!
ConnectorInterface
ConnectorInterface defines an abstract interface (set of actions) that could be implemented by multiple connectors
Fields
-
ID!
ConnectorVersion
ConnectorVersion contains the versioned attributes of a connector interface
Fields
-
ID!
PageInfo
Fields
-
String
-
Boolean!
-
String
-
Boolean!
Playbook
Playbook is an entry in catalog of available playbooks
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
[String!]
-
String
-
String
-
PlaybookVersion!
-
[PlaybookVersion!]!
-
[PlaybookInstance!]!
-
[ConnectorCategory!]!
-
String
-
String
-
[ConnectorInterface!]!
-
Int
PlaybookEvent
PlaybookEvents represents a trace event withing the execution of the workflow
Fields
-
Int
-
PlaybookObject!
-
PlaybookState!
-
String
-
Time!
-
JSONObject
-
Any
-
String
-
Int
PlaybookExecution
PlaybookExecution represents the state of a current playbook execution
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String
-
PlaybookState
-
String!
-
PlaybookInstance!
-
PlaybookVersion
-
JSONObject
-
Any
-
String!
-
[PlaybookEvent!]!
-
Int
PlaybookExecutionLog
PlaybookExecutionLog represents a log entry from an executed playbook with it's children and status logs attached
Fields
-
ID!
-
Float
-
Float
-
JSONObject
-
Any
-
Any
PlaybookExecutions
PlaybookExecutions represents a list of executions along with other metadata like pagination
Fields
PlaybookExecutionsV2
Fields
PlaybookExport
Fields
-
String!
PlaybookInstance
PlaybookInstance defines the configuration of a playbook in a user account
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
String
-
[String!]
-
String
-
Playbook!
-
PlaybookVersion
-
PlaybookVersionStrategy
-
PlaybookTrigger
-
Boolean!
-
JSONObject
-
PlaybookRetries
-
[Connection!]!
-
[PlaybookInterfaceInstance!]!
-
String!
-
Int
PlaybookInterface
PlaybookInterface defines a contract that can be implemented by one ore more playbooks
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
String
-
[String!]
-
PlaybookInterfaceVersion!
-
[PlaybookInterfaceVersion!]!
PlaybookInterfaceVersion
PlaybookInterfaceVersion maintains a change record of the playbook interface.
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
SemVer
-
Time
-
String
-
PlaybookInterface!
-
String
-
String
-
String
-
String
-
String
-
JSONSchema
-
JSONSchema
PlaybookRetries
Fields
-
Int
-
Int
-
Float
-
Int
-
Int
-
Int
-
Int
-
Float
-
Int
-
Int
PlaybookTrigger
PlaybookTrigger defines a set of attributes common to different trigger types
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
String
-
String!
-
PlaybookTriggerType!
-
JSONObject!
-
PlaybookInstance!
PlaybookTriggerType
PlaybookTriggerType defines an available triggering mechanism
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String!
-
String
-
JSONSchema
PlaybookValidationError
Fields
-
String!
-
Int!
PlaybookVersion
PlaybookVersion maintains a change record of the playbook definition. Multiple versions of a playbook could be in use concurrently
Fields
-
ID!
-
Time!
-
String!
-
Time!
-
String!
-
String
-
SemVer
-
Time
-
String
-
Playbook!
-
[PlaybookInstance!]!
-
String
-
String
-
String
-
String
-
String
-
[ConnectorVersion!]!
-
[PlaybookVersion!]!
-
[PlaybookInterfaceVersion!]!
-
JSONSchema
-
JSONSchema
-
String
-
PlaybookInterface
-
JSONObject
TenantContext
Fields
-
String!
-
String!
-
[String!]!
-
[String!]!
ClonePlaybookInput
ClonePlaybookInput defines the fields required to clone a playbook
Fields
-
String!
-
ID!
-
ID!
-
Boolean
CreatePlaybookInput
CreatePlaybookInput defines the playbook fields that are required and/or avaliable on creation of a playbook
CreatePlaybookInterfaceInput
CreatePlaybookInterfaceInput defines the fields needed to create a playbook interface
Fields
-
String!
-
[String!]
-
String
-
CreatePlaybookInterfaceVersionInput!
CreatePlaybookInterfaceVersionInput
CreatePlaybookInterfaceVersionInput defines the fields used to create a playbook interface version
Fields
-
String
-
String
-
String
-
String
-
String
-
JSONSchema
-
JSONSchema
-
SemVer
CreatePlaybookVersionInput
CreatePlaybookVersionInput defines the fields used to create a playbook version
Fields
-
String
-
String
-
String
-
String
-
String
-
IDs
-
IDs
-
JSONSchema
-
JSONSchema
-
YAMLObject
-
SemVer
-
ID
-
IDs
DeletePlaybookInterfaceInput
DeletePlaybookInterfaceInput defines the fields needed to delete a playbook interface
Fields
-
ID!
DeletePlaybookInterfaceVersionInput
DeletePlaybookInterfaceVersionInput defines the fields needed to delete a playbook interface version
Fields
-
ID!
DeletePlaybookVersionInput
DeletePlaybookVersionInput defines the fields needed to delete a playbook version
Fields
-
ID!
ImportPlaybookInput
Fields
-
Upload!
-
Boolean
Pagination
Pagination defines the options for requesting specific pages and the number of results per page
Fields
-
Int
-
Int
PlaybookArguments
PlaybookArguments define the fields available to lookup a single playbook. At least one of playbookId or playbookName must be set. If both are set, then both the id and name must match an existing playbook.
Fields
-
ID
-
String
PlaybookExecutionInput
PlaybookExecutionInput allows for an external trigger to create a playbook execution to record errors evaluating filter conditions
Fields
-
ID!
-
PlaybookState
-
JSONObject
-
[PlaybookExecutionLogInput!]
PlaybookExecutionLogInput
PlaybookExecutionLogInput defines logs to be recorded
Fields
-
PlaybookExecutionLogLevel!
-
String!
-
JSONObject
-
String
PlaybookExecutionsV2Arguments
Fields
-
Int
Returns the first n results (used for forward traversal) -
String
Used to get the next page of results in conjunction with first; after the endCursor of the current page (used for forward traversal) -
Int
Returns the last n results of a previous page when used in conjunction with before (used for backwards traversal) -
String
Used to get the previous page of results; before the startCursor of the current page (used for backwards traversal) -
PlaybookExecutionsSort
-
PaginationOrder
-
ID
-
ID
-
PlaybookState
-
Time
-
Time
-
Time
-
Time
PlaybookExportArguments
Fields
-
ID
-
String
PlaybookInstanceInput
PlaybookInstanceInput defines the mutable fields of a playbook instance
Fields
-
String!
-
String
-
Tags
-
PlaybookVersionStrategy
The desired strategy that should be followed when a playbook is updated or a new version is published. This field should be treated as if it was required (subsequent api versions will require it) but if not provided, it will default FollowMajorVersion or the existing strategy for the instance. -
ID
-
ID
The desired playbook version the instance should use. If not provided, it will default to the current head version of the playbook. If the versionStrategy is set to fixed, the version will not automatically update; for all other strategies, the version will automatically update based on the selected strategy when new playbooks are published. -
PlaybookTriggerInput!
-
Boolean!
-
JSONObject
-
IDs
-
[PlaybookInterfaceInstanceInput!]
PlaybookInterfaceArguments
PlaybookInterfaceArguments define the fields to lookup a single PlaybookInterface. At least one of playbookInterfaceId or playbookInterfaceName must be set. If both are set, then both the id and name must match an existing PlaybookInterface.
Fields
-
ID
-
String
PlaybookInterfaceInstanceInput
Fields
-
ID!
-
ID!
-
ID!
-
IDs
PlaybookInterfaceVersionArguments
PlaybookInterfaceVersionArguments define the fields to lookup a single PlaybookInterfaceVersion. At least one of playbookInterfaceVersionId or playbookInterfaceVersionName must be set. If both are set, then both the id and name must match an existing PlaybookInterfaceVersion.
Fields
-
ID
-
String
PlaybookInterfaceVersionsArguments
PlaybookInterfaceVersionsArguments defines the fields to lookup a list of PlaybookInterfaceVersions. All parameters are optional. If the playbookInterfaceID is provided, it will match all PlaybookInterfaceVersions that match that PlaybookInterface ID. If the playbookInterfaceVersionNames is provided, then the names of the PlaybookInterfaceVersions or the PlaybookInterfaces must match this list. While both parematers can be suppled, in most cases only one of the parameters is typically used.
Fields
-
ID
-
[String!]
PlaybookTriggerInput
Fields
-
String!
-
String
-
Tags
-
ID!
-
JSONObject!
PlaybookValidationArguments
Fields
-
Upload
-
String
PlaybookVersionArguments
PlaybookVersionArguments define the fields available to lookup a single playbook. At least one of playbookVersionId or playbookVersionName must be set. If both are set, then both the id and name must match an existing playbook.
Fields
-
ID
-
String
PlaybooksImplementingArguments
Fields
-
[ID!]
-
[String!]
PublishPlaybookInterfaceVersionInput
PublishPlaybookInterfaceVersionInput defines the fields required to publish a playbook interface version
Fields
-
ID!
-
SemVer!
PublishPlaybookVersionInput
PublishPlaybookVersionInput defines the fields required to publish a playbook version
Fields
-
ID!
-
SemVer!
QueryOptions
QueryOptions provides the ability to override default query behavior
Fields
-
Boolean
reversed default timestamp order of descending -
Int
UpdatePlaybookInput
UpdatePlaybookInput defines the fields required and the mutable fields that can be used to update a playbook.
Fields
-
ID!
-
[String!]
-
String
-
IDs
-
ID
UpdatePlaybookInterfaceInput
UpdatePlaybookInterfaceInput defines the fields needed to update a playbook interface
Fields
-
ID!
-
[String!]
-
String
-
ID
UpdatePlaybookInterfaceVersionInput
UpdatePlaybookInterfaceVersionInput defines the fields used to update a playbook interface version
Fields
-
ID!
-
String
-
String
-
String
-
String
-
String
-
JSONSchema
-
JSONSchema
-
SemVer
UpdatePlaybookVersionInput
UpdatePlaybookVersionInput defines the mutable fields of a playbook version
Fields
-
ID!
-
String
-
String
-
String
-
String
-
String
-
IDs
-
IDs
-
JSONSchema
-
JSONSchema
-
YAMLObject
-
SemVer
-
ID
-
IDs
Any
interface
IDs
list of IDs
JSONObject
JSON payload
JSONSchema
JSON schema
PaginationOrder
Possible Values
PlaybookExecutionLogLevel
Possible Values
PlaybookExecutionsSort
Possible Values
PlaybookObject
Possible Values
PlaybookState
Possible Values
PlaybookVersionStrategy
PlaybookVersionStrategy determines how an instance is upgraded when new versions are published
Possible Values
SemVer
Semantic Version
Tags
list of tags
Time
Time implementation for this library.
Upload
File to upload
YAMLObject
YAML payload
Threat Intel Queries
threatPublication
Retreives a publication by ID.Parameters
-
String!
Return Value
-
ThreatPublication!
Retreives a publication by ID.
threatPublications
Searches publications for text.Parameters
-
String!
Return Value
-
[ThreatPublication]
Searches publications for text.
threatLatestPublications
Gets the latest publications from an offset with a size.Parameters
-
Int!
-
Int!
Return Value
-
[ThreatPublication]
Gets the latest publications from an offset with a size.
threatObjectById
Gets an object by `id`, `name` or `sharing_id`.Parameters
-
String!
-
ThreatObjectType!
Return Value
-
ThreatResult
Gets an object by `id`, `name` or `sharing_id`.
threatIdentitiesByConfidence
Gets identities by confidence score.Parameters
-
Int!
Return Value
-
[ThreatResult]
Gets identities by confidence score.
threatObjectsRelated
Checks if a relationship between source and target exists.Parameters
-
String!
-
String!
Return Value
-
Boolean!
Checks if a relationship between source and target exists.
threatGetRelated
Gets relationship(s) between source and target(s).Parameters
-
String!
Return Value
-
[ThreatResult]
Gets relationship(s) between source and target(s).
threatWatchlist
Gets a watchlist by type. All results are considered **high confidence**.Parameters
Return Value
-
[ThreatRelationship]
Gets a watchlist by type. All results are considered **high confidence**.
threatIndicatorPublications
Gets publications related to indicators.Parameters
-
String!
Return Value
-
[ThreatReport]
Gets publications related to indicators.
threatIndicatorIntelligence
Retrieves all intelligence associated with an indicator.Parameters
-
String!
Return Value
-
ThreatIndicatorIntelligence
Retrieves all intelligence associated with an indicator.
threatRelationship
Gets relationship by `id`.Parameters
-
String!
Return Value
-
ThreatRelationship
Gets relationship by `id`.
threatIdentity
Gets identity by `id`.Parameters
-
String!
Return Value
-
ThreatIdentity
Gets identity by `id`.
threatMalware
Gets malware by `id`.Parameters
-
String!
Return Value
-
ThreatMalware
Gets malware by `id`.
threatIdentities
Gets identities by confidence score.Parameters
-
Int
Return Value
-
[ThreatIdentity]
Gets identities by confidence score.
threatVidIntelligence
Retrieves all intelligence associated with a `VID`.Parameters
-
String!
Return Value
-
ThreatVidIntelligence
Retrieves all intelligence associated with a `VID`.
threatIndicatorsIntelligence
Retrieves all intelligence associated with a list of indicators.Parameters
-
[String!]
Return Value
-
[ThreatIndicatorIntelligence]
Retrieves all intelligence associated with a list of indicators.
list
Retrieves a custom list by IDParameters
-
String!
-
ListsArguments!
Return Value
-
List
Retrieves a custom list by ID
listItemsByTag
Retrieves list items that contains the specified tag (case sensitive)Parameters
-
String!
-
ListsArguments!
Return Value
-
ListItems
Retrieves list items that contains the specified tag (case sensitive)
listItemsByName
Retrieves list items by indicator nameParameters
-
String!
-
ListsArguments!
Return Value
-
ListItems
Retrieves list items by indicator name
Threat Intel Mutations
List
Fields
-
ID!
-
String!
-
String
-
String
-
ListOwner!
-
Int
-
Boolean!
-
Boolean!
-
Int
-
Int
-
[String]
-
[ListItem!]
-
ListAction!
-
Time!
-
Time!
-
Time
-
Time
ListInfo
Fields
-
String!
-
Int!
-
String!
-
ListAction!
ListItemToList
Fields
-
String!
-
String!
-
ListItem
ListItems
Fields
Lists
Fields
ThreatAdvisory
Represents a CTU threat advisory report.
ThreatAnalysis
Represents a threat analysis report.
ThreatDNSInfo
Contains relevant DNS information when it is available.
Fields
-
String
-
String
-
String
-
String
ThreatGroup
Represents a _threat group_.
Fields
-
ThreatObjectType!
-
String!
-
String!
-
String!
-
String!
-
[String]
-
[String]
-
[String]
-
[String]
-
[String]
-
[String]
-
String
-
Time
-
Time
-
[String]
ThreatIdentity
Commonly represents a source of threat data.
Fields
-
ThreatObjectType!
-
String!
-
String!
-
String!
-
String!
-
String
-
Time
-
Time
-
[String]
-
ThreatIdentityClass
-
[ThreatIndustrySectors]
-
String
-
String
-
String!
-
Boolean!
-
Int
-
[String]
-
String
-
[String]
ThreatIndicator
Represents an indicator of compromise.
Fields
-
ThreatObjectType!
-
String!
-
String!
-
String!
-
String!
-
String
-
Time
-
Time
-
[ThreatIndicatorType]
-
String
-
ThreatPatternType
-
String
-
[String]
-
Time
-
Time
-
[ThreatKillChainPhase]
-
Int
-
String
-
ThreatIndicatorClass
-
String
-
String
-
ThreatDNSInfo
-
ThreatWhois
-
ThreatURLInfo
-
[String]
-
ThreatLocation
ThreatKillChainPhase
`ThreatKillChainPhase` represents a phase in a kill chain, which describes the various phases an attacker may undertake in order to achieve their objectives.
Fields
-
String
-
String
ThreatLocation
`ThreatLocation` provides geolocation longitude and latitude coordinates as an indicator. Provided when available.
Fields
-
Float
-
Float
ThreatMalware
Provides available information about malware.
Fields
-
ThreatObjectType!
-
String!
-
String!
-
String!
-
String!
-
String
-
Time
-
Time
-
[ThreatMalwareType]
-
String
-
[String]
-
[ThreatKillChainPhase]
-
Time
-
Time
-
[String]
-
[ThreatArchitectureExecutionEnvs]
-
[ThreatImplementationLanguages]
-
[ThreatCapabilities]
-
[String]
-
String
-
[String]
-
String
-
String
-
String
ThreatPublication
Represents a publication about a threat.
Fields
-
ID!
-
String
-
String
-
String
-
Time
-
String
-
String
-
String
-
String
-
String
-
String
ThreatRelationship
Represents the relationship between objects in the system.
Fields
-
ThreatObjectType!
-
String!
-
String!
-
String!
-
String!
-
String!
-
Time
-
Time
-
String
-
String
-
String
-
[String]
-
ThreatRelationshipType!
-
String!
-
String!
-
Int
-
ThreatIndicatorClass
-
String
-
[String]
-
Time
-
Time
-
Boolean!
-
String
ThreatReport
Fields
-
ThreatObjectType!
-
String!
-
ID!
-
String
-
String
-
Time
-
Time
-
Time
-
[String]
-
String
-
String!
-
[String]
ThreatSwid
`ThreatSwid` represents an internal SWID structure. !!! Important For future use. Not currently implemented.
Fields
-
String
-
String
-
Time
-
String
-
String
-
Int
-
String
-
Int
-
Int
-
String
-
String
ThreatURLInfo
Contains the parsed components of a URL when it is available.
Fields
-
String
-
String
-
String
-
String
-
String
ThreatVid
Fields
-
String
-
String
-
[ThreatSwid]
-
[ThreatAnalysis]
-
[ThreatGroup]
ThreatWhois
Provides any available **whois** information about an indicator.
Fields
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
-
String
CreateListInput
Fields
-
String!
-
String
-
String
-
[ListItemInput!]
-
ListAction!
-
Int!
-
Int!
-
[String]
DeleteListInput
Fields
-
ID!
ListItemInput
Fields
-
String
-
String!
-
String
-
ItemType!
-
Int!
-
Int!
-
[String]
ListsArguments
Fields
-
Boolean
-
Int
-
Int
-
OrderByOptions
ThreatHashesInput
Fields
-
String!
-
String!
ThreatIdentityInput
Fields
-
String!
-
String
-
[String]
-
ThreatIdentityClass
-
[ThreatIndustrySectors]
-
String
-
String
-
String!
-
Boolean
-
Int!
-
[String]
ThreatIndicatorInput
Fields
-
String
-
String
-
[ThreatIndicatorType]
-
String
-
ThreatPatternType
-
String
-
Time
-
Time
-
[ThreatKillChainPhaseInput]
-
Int
ThreatKillChainPhaseInput
Fields
-
String
-
String
ThreatRelationshipInput
Fields
-
ThreatObjectType!
-
String!
-
String!
-
String
-
String
-
String
-
[String]
-
ThreatRelationshipType!
-
String!
-
String!
-
Int
-
ThreatIndicatorClass
-
[String]
-
Boolean!
-
String
-
Time
-
Time
ThreatSwidInput
Fields
-
String
-
String
-
Time
-
String
-
String
-
Int
-
String
-
Int
-
Int
-
String
-
String
ItemType
Possible Values
ListAction
Possible Values
OrderByOptions
Possible Values
ThreatArchitectureExecutionEnvs
ThreatArchitectureExecutionEnvs !!! Important For future use. Not currently implemented.
Possible Values
ThreatCapabilities
Defines the capabilites of a threat. !!! Important For future use. Not currently implemented.
Possible Values
ThreatIdentityClass
`ThreatIdentityClass` describes the type of entity that the Identity represents: whether it describes an organization, group, individual, or class.
Possible Values
ThreatImplementationLanguages
ThreatImplementationLanguages !!! Important For future use. Not currently implemented.
Possible Values
ThreatIndicatorType
`ThreatIndicatorType` is an open vocabulary used to categorize **Indicators**. It is intended to be high-level to promote consistent practices. Indicator types should not be used to capture information that can be better captured from related _Malware_ or _Attack Pattern_ objects. !!! Note It is better to link an **Indicator** to a _Malware_ object.
Possible Values
ThreatPatternType
`ThreatPatternType` is a non-exhaustive, open vocabulary that covers common pattern languages and is intended to characterize the pattern language that the indicator pattern is expressed in.