Skip to content
API Reference
/
/
listDataSourceTypes

GraphQL Overview

Download GraphQL schema
agent.graphql

Queries

Overview

accessChannels

(...args)
AccessChannelsResponse!,non-null

Arguments

filter
AccessChannelFilterInput
orderBy
[AccessChannelOrderByInput!],non-null
limit
Int
offset
Int

Return type

AccessChannelsResponse!
items
[InventoryAccessChannelListItem!]!,non-null
total
Int!,non-null
Query sample
query accessChannels(
  $filter: AccessChannelFilterInput
  $orderBy: [AccessChannelOrderByInput!]
  $limit: Int
  $offset: Int
) {
  accessChannels(
    filter: $filter
    orderBy: $orderBy
    limit: $limit
    offset: $offset
  ) {
    items {
      __typename
      # ...InventoryAccessChannelListItemFragment
    }
    total 
  }
}
Variables
{
  "filter": {
    "id": {
      "__typename": "StringFilter"
    },
    "search": "Example String",
    "enabled": {
      "__typename": "BooleanFilter"
    },
    "type": {
      "__typename": "StringFilter"
    },
    "environment": {
      "__typename": "EnvironmentFilter"
    },
    "findings": {
      "__typename": "FindingFilter"
    }
  },
  "orderBy": [
    {
      "field": "NAME",
      "direction": "ASC"
    }
  ],
  "limit": 40,
  "offset": 40
}
Response sample
{
  "data": {
    "items": [
      {
        "__typename": "InventoryAccessChannelListItem"
      }
    ],
    "total": 40
  }
}

accessChannel

(id)
InventoryAccessChannel

Arguments

id
ID!,non-nullrequired

Return type

InventoryAccessChannel
id
ID!,non-null
externalId
ID!,non-null
name
String!,non-null
type
String!,non-null
enabled
Boolean!,non-null
environment
Environment!,non-null
createdAt
DateTime!,non-null
updatedAt
DateTime!,non-null
metadata
JSON
agent
InventoryAgent!,non-null
findings
[Finding!],non-null
issues
[Issue!],non-null
detections
[DetectionTypeAggregation!],non-null
Query sample
query accessChannel($id: ID!) {
  accessChannel(id: $id) {
    id 
    externalId 
    name 
    type 
    enabled 
    environment {
      __typename
      # ...EnvironmentFragment
    }
    createdAt 
    updatedAt 
    metadata 
    agent {
      __typename
      # ...InventoryAgentFragment
    }
    findings {
      __typename
      # ...FindingFragment
    }
    issues {
      __typename
      # ...IssueFragment
    }
    detections {
      __typename
      # ...DetectionTypeAggregationFragment
    }
  }
}
Variables
{
  "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4"
}
Response sample
{
  "data": {
    "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4",
    "externalId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4",
    "name": "Example String",
    "type": "Example String",
    "enabled": true,
    "environment": {
      "__typename": "Environment"
    },
    "createdAt": "Example Custom Scalar",
    "updatedAt": "Example Custom Scalar",
    "metadata": "Example Custom Scalar",
    "agent": {
      "__typename": "InventoryAgent"
    },
    "findings": [
      {
        "__typename": "Finding"
      }
    ],
    "issues": [
      {
        "__typename": "Issue"
      }
    ],
    "detections": [
      {
        "__typename": "DetectionTypeAggregation"
      }
    ]
  }
}

inventoryCategories

InventoryCategoriesResponse!,non-null

Return type

InventoryCategoriesResponse!
categories
[InventoryCategory!]!,non-null
Query sample
query inventoryCategories {
  inventoryCategories {
    categories {
      __typename
      # ...InventoryCategoryFragment
    }
  }
}
Response sample
{
  "data": {
    "categories": [
      {
        "__typename": "InventoryCategory"
      }
    ]
  }
}

listToolTypes

[String!]!,non-null

Return type

[String!]!

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.

Query sample
query listToolTypes {
  listToolTypes 
}
Response sample
{
  "data": [
    "Example String"
  ]
}

topToolByExternalType

(...args)
[ToolExternalTypeCount!]!,non-null

Arguments

limit
Int
before
DateTime
after
DateTime

Return type

[ToolExternalTypeCount!]!
type
String!,non-null
count
Int!,non-null
Query sample
query topToolByExternalType(
  $limit: Int
  $before: DateTime
  $after: DateTime
) {
  topToolByExternalType(
    limit: $limit
    before: $before
    after: $after
  ) {
    type 
    count 
  }
}
Variables
{
  "limit": 40,
  "before": "Example Custom Scalar",
  "after": "Example Custom Scalar"
}
Response sample
{
  "data": [
    {
      "type": "Example String",
      "count": 40
    }
  ]
}

listDataSourceTypes

[String!]!,non-null

Return type

[String!]!

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.

Query sample
query listDataSourceTypes {
  listDataSourceTypes 
}
Response sample
{
  "data": [
    "Example String"
  ]
}

listChannelTypes

[String!]!,non-null

Return type

[String!]!

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.

Query sample
query listChannelTypes {
  listChannelTypes 
}
Response sample
{
  "data": [
    "Example String"
  ]
}

sessionActivities

(sessionId)
[SessionSubActivity!]!,non-null

Arguments

sessionId
ID!,non-nullrequired

Return type

[SessionSubActivity!]!
PolicyEvaluatedActivity
UserMessageActivity
AgentMessageActivity
AgentReasoningActivity
ToolCallActivity
ErrorActivity
SessionStartedActivity
DataSourceAccessActivity
AccessChannelActivity
Query sample
query sessionActivities($sessionId: ID!) {
  sessionActivities(sessionId: $sessionId) {
    id 
    type 
    timestamp 
    agent {
      __typename
      # ...AgentFragment
    }
    message 
    policy {
      __typename
      # ...PolicyFragment
    }
    issue {
      __typename
      # ...IssueFragment
    }
  }
}
Variables
{
  "sessionId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4"
}
Response sample
{
  "data": [
    {
      "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4",
      "type": "SESSION",
      "timestamp": "Example Custom Scalar",
      "agent": {
        "__typename": "Agent"
      },
      "message": "Example String",
      "policy": {
        "__typename": "Policy"
      },
      "issue": {
        "__typename": "Issue"
      }
    }
  ]
}

sessions

(...args)
[Session!]!,non-null

Arguments

filter
SessionFilter
orderBy
[SessionOrderByInput!],non-null
limit
Int
Default:100
offset
Int
Default:0

Return type

[Session!]!
type
ActivityType!,non-null
timestamp
DateTime!,non-null
agent
Agent!,non-null
message
String
sessionId
ID!,non-null
detections
[Detection!]!,non-null

Detections that were created as part of the session

violations
[ViolationPreview!]!,non-null

Violations that were created as part of the session.

Query sample
query sessions(
  $filter: SessionFilter
  $orderBy: [SessionOrderByInput!]
  $limit: Int
  $offset: Int
) {
  sessions(
    filter: $filter
    orderBy: $orderBy
    limit: $limit
    offset: $offset
  ) {
    type 
    timestamp 
    agent {
      __typename
      # ...AgentFragment
    }
    message 
    sessionId 
    detections {
      __typename
      # ...DetectionFragment
    }
    violations {
      __typename
      # ...ViolationPreviewFragment
    }
  }
}
Variables
{
  "filter": {
    "sessionId": {
      "__typename": "StringFilter"
    },
    "activityType": {
      "__typename": "ActivityTypeFilter"
    },
    "dateRange": {
      "__typename": "DateTimeFilter"
    },
    "agent": {
      "__typename": "AgentReferenceFilter"
    },
    "search": "Example String",
    "findingType": {
      "__typename": "FindingTypeFilter"
    },
    "issue": {
      "__typename": "IssueReferenceFilter"
    },
    "detections": {
      "__typename": "DetectionFilter"
    },
    "tool": {
      "__typename": "ToolReferenceFilter"
    },
    "dataSource": {
      "__typename": "DataSourceReferenceFilter"
    },
    "accessChannel": {
      "__typename": "AccessChannelReferenceFilter"
    }
  },
  "orderBy": [
    {
      "field": "TIMESTAMP",
      "direction": "ASC"
    }
  ],
  "limit": 40,
  "offset": 40
}
Response sample
{
  "data": [
    {
      "type": "SESSION",
      "timestamp": "Example Custom Scalar",
      "agent": {
        "__typename": "Agent"
      },
      "message": "Example String",
      "sessionId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4",
      "detections": [
        {
          "__typename": "Detection"
        }
      ],
      "violations": [
        {
          "__typename": "ViolationPreview"
        }
      ]
    }
  ]
}

sessionsCount

(filter)
Int!,non-null

Arguments

filter
SessionFilter

Return type

Int!

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

Query sample
query sessionsCount($filter: SessionFilter) {
  sessionsCount(filter: $filter) 
}
Variables
{
  "filter": {
    "sessionId": {
      "__typename": "StringFilter"
    },
    "activityType": {
      "__typename": "ActivityTypeFilter"
    },
    "dateRange": {
      "__typename": "DateTimeFilter"
    },
    "agent": {
      "__typename": "AgentReferenceFilter"
    },
    "search": "Example String",
    "findingType": {
      "__typename": "FindingTypeFilter"
    },
    "issue": {
      "__typename": "IssueReferenceFilter"
    },
    "detections": {
      "__typename": "DetectionFilter"
    },
    "tool": {
      "__typename": "ToolReferenceFilter"
    },
    "dataSource": {
      "__typename": "DataSourceReferenceFilter"
    },
    "accessChannel": {
      "__typename": "AccessChannelReferenceFilter"
    }
  }
}
Response sample
{
  "data": 40
}

activitiesTimelineChart

(input)
ActivitiesTimelineChartResponse!,non-null

Arguments

input
TimelineQueryInput!,non-nullrequired

Return type

ActivitiesTimelineChartResponse!
metadata
TimelineQueryMetadata!,non-null
bins
[ActivitiesTimelineBin!]!,non-null
totalActivities
Int!,non-null
totalIndicators
Int!,non-null
Query sample
query activitiesTimelineChart($input: TimelineQueryInput!) {
  activitiesTimelineChart(input: $input) {
    metadata {
      __typename
      # ...TimelineQueryMetadataFragment
    }
    bins {
      __typename
      # ...ActivitiesTimelineBinFragment
    }
    totalActivities 
    totalIndicators 
  }
}
Variables
{
  "input": {
    "timeRange": {
      "__typename": "DateTimeFilter"
    },
    "binCount": 40,
    "timezone": "Example String",
    "filters": {
      "__typename": "SessionFilter"
    }
  }
}
Response sample
{
  "data": {
    "metadata": {
      "__typename": "TimelineQueryMetadata"
    },
    "bins": [
      {
        "__typename": "ActivitiesTimelineBin"
      }
    ],
    "totalActivities": 40,
    "totalIndicators": 40
  }
}

Mutations

Overview

Objects

Overview

Interfaces

Overview

Unions

Overview

Enums

Overview

Inputs

Overview

Scalars

Overview