GRgrepr
Splunk Integration

Update a Splunk integration.

Updates an integration to connect to Splunk. The version should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.

put/v1/integrations/splunk/{id}

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)

Path parameters

idstring required

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 updated 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.