Create Context Integration

post https://api.netography.com/api/v1/integrations/context

Creates a context integration from the data that's been supplied. Do not provide an id. IDs are auto generated

time	status	user agent
Retrieving recent requests…

Loading…

Body Params

Integration to be added. Parameters are dependant on which context 'type' is provided.

name

string

required

The name of the context integration

type

string

required

The type of the context integration. The configuration parameters are dependent on this value.

enabled

boolean

required

The state of the context integration. Whether to auto update or not.

updateinterval

int32

required

3600 to 604800

The number of seconds by which to poll the integration.

aws

object

Configuration options specific to type aws. nil if not configuring AWS

azure

object

Configuration options specific to type azure. nil if not configuring Azure

crowdstrike

object

Configuration options specific to crowdstrike. nil if not configuring CrowdStrike Falcon.

crowdstrikediscover

object

Configuration options specific to crowdstrikediscover. nil if not configuring CrowdStrike Discover Falcon.

ibm

object

Configuration options specific to ibm. nil if not configuring IBM Cloud

oracle

object

Configuration options specific to oracle. nil if not configuring Oracle Cloud

gcp

object

Configuration options specific to gcp. nil if not configuring GCP

object

Configuration options specific to type s3.
This is used for pulling a CSV file from an S3 bucket. The format of the file is ip,context,label1,label2 etc. nil if not configuring S3

sentinelone

object

Configuration options specific to sentinelone. nil if not configuring SentinelOne

wiz

object

Configuration options specific to wiz. nil if not configuring Wiz

Responses

Language

Credentials

Bearer

JWT


xxxxxxxxxx
26
1
curl --request POST \
2
     --url https://api.netography.com/api/v1/integrations/context \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "type": "aws",
8
  "enabled": true,
9
  "aws": {
10
    "awsauthtype": "AccessKey"
11
  },
12
  "crowdstrike": {
13
    "cloud": "us-1"
14
  },
15
  "crowdstrikediscover": {
16
    "cloud": "us-1"
17
  },
18
  "s3": {
19
    "awsauthtype": "AccessKey"
20
  },
21
  "wiz": {
22
    "apiendpoint": "https://api.us1.app.wiz.io/graphql",
23
    "tokenurl": "https://auth.app.wiz.io/oauth/token"
24
  }
25
}
26
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201List of Context Integrations Requested, or an array containing the new/updated Context Integration after a Create or Update operation.

400Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

401Access token is missing or invalid

defaultUnknown Error Occurred