Update a log stream

Update a log stream.

Examples of how to use the PATCH endpoint.

The following fields may be updated in a PATCH operation:

• name
• status
• sink

Note: For log streams of type eventbridge and eventgrid, updating the sink is not permitted.

Update the status of a log stream

{
  "status": "active|paused"
}

Update the name of a log stream

{
  "name": "string"
}

Update the sink properties of a stream of type http

{
  "sink": {
    "httpEndpoint": "string",
    "httpContentType": "string",
    "httpContentFormat": "JSONARRAY|JSONLINES",
    "httpAuthorization": "string"
  }
}

Update the sink properties of a stream of type datadog

{
  "sink": {
    "datadogRegion": "string",
    "datadogApiKey": "string"
  }
}

Update the sink properties of a stream of type splunk

{
  "sink": {
    "splunkDomain": "string",
    "splunkToken": "string",
    "splunkPort": "string",
    "splunkSecure": "boolean"
  }
}

Update the sink properties of a stream of type sumo

{
  "sink": {
    "sumoSourceAddress": "string"
  }
}

PATCH https://{tenantDomain}/api/v2/log-streams/{id}

Go

Go

package example

import (
    context "context"

    management "github.com/auth0/go-auth0/management/management"
    client "github.com/auth0/go-auth0/management/management/client"
    option "github.com/auth0/go-auth0/management/management/option"
)

func do() {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    request := &management.UpdateLogStreamRequestContent{}
    client.LogStreams.Update(
        context.TODO(),
        "id",
        request,
    )
}

200

{
  "id": "<string>",
  "name": "<string>",
  "isPriority": true,
  "filters": [
    {}
  ],
  "pii_config": {
    "log_fields": []
  },
  "sink": {
    "httpEndpoint": "<string>",
    "httpAuthorization": "<string>",
    "httpContentType": "<string>",
    "httpCustomHeaders": [
      {
        "header": "<string>",
        "value": "<string>"
      }
    ]
  }
}

Authorizations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

The id of the log stream to get

Body

application/jsonapplication/x-www-form-urlencoded

name · string

log stream name

status · enum<string>

The status of the log stream. Possible values: active, paused, suspended

Available options: active, paused, suspended

isPriority · boolean

True for priority log streams, false for non-priority

filters · object[]

Only logs events matching these filters will be delivered by the stream. If omitted or empty, all events will be delivered.

Show child attributes

pii_config · object

Show child attributes

sink · object

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Show child attributes

Response

200

application/json

Log stream updated

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

id · string<log-stream-id>

The id of the log stream

name · string

log stream name

status · enum<string>

The status of the log stream. Possible values: active, paused, suspended

Available options: active, paused, suspended

type · enum<string>

Available options: http

isPriority · boolean

True for priority log streams, false for non-priority

filters · object[]

Only logs events matching these filters will be delivered by the stream. If omitted or empty, all events will be delivered.

Show child attributes

pii_config · object

Show child attributes

sink · object

Show child attributes