GRgrepr
Splunk Integration

Create a Splunk integration

Creates an integration to connect to Splunk.

post/v1/integrations/splunk

Request

  • Base URL
    https://docs.grepr.ai (the document declares no server; this is the origin it was published from)
  • Auth
    OpenID Connect (https://grepr-prod.us.auth0.com/.well-known/openid-configuration)

Request body

namestring required

Name of the integration.

teamIdsstring[]

The team IDs that this integration is associated with.

type'splunk' required

The type of the integration. This is used to determine the payload type.

versioninteger required

Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.

Example request

{
  "name": "my_integration",
  "payload": {
    "additionalTags": [
      "tag1:value1",
      "tag2:value2"
    ],
    "authToken": "**************ey",
    "filterQuery": "service:my-service",
    "ingestHost": "splunkcloud.com",
    "ingestPort": "8088",
    "restAuthToken": "**************ey",
    "restHost": "splunkcloud.com",
    "restPort": "8089",
    "splunkHost": "splunkcloud.com",
    "webHost": "splunkcloud.com",
    "webPort": "443"
  }
}

Response

Integration created successfully

createdAtstring date-time required

Timestamp when the integration was created.

idstring required

The integration id

jobIdsstring[] required

List of job IDs associated with the integration.

namestring required

Name of the integration.

organizationIdstring required

Organization ID of the integration.

teamIdsstring[]

The team IDs that this integration is associated with.

type'splunk' required

The type of the integration. This is used to determine the payload type.

updatedAtstring date-time required

Timestamp when the integration was last updated.

versioninteger required

Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.

Example response

{
  "name": "my_integration",
  "payload": {
    "additionalTags": [
      "tag1:value1",
      "tag2:value2"
    ],
    "authToken": "**************ey",
    "filterQuery": "service:my-service",
    "ingestHost": "splunkcloud.com",
    "ingestPort": "8088",
    "restAuthToken": "**************ey",
    "restHost": "splunkcloud.com",
    "restPort": "8089",
    "splunkHost": "splunkcloud.com",
    "webHost": "splunkcloud.com",
    "webPort": "443"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.