---
title: "Update log stream"
method: POST
path: "/update_log_stream/{id}"
tags: ["Log Streams"]
---

# Update log stream

`POST /update_log_stream/{id}`

## Request

- Base URL: `https://happy-animal-123.convex.cloud/api/v1`
- URL: `https://happy-animal-123.convex.cloud/api/v1/update_log_stream/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - API key in header `Authorization`

Update an existing log stream for the deployment. Omit a field to keep the
existing value, and use `null` to unset a field.

## Path parameters

- `id` string, required

## Request body

- union
  - object
    - `siteLocation` 'US1' | 'US3' | 'US5' | 'EU' | 'US1_FED' | 'AP1': The Datadog deployment locations, used to construct URLs
    - `ddApiKey` string, nullable: Datadog API key for authentication.
    - `ddTags` string[], nullable: Optional comma-separated list of tags. These are sent to Datadog in each log event via the `ddtags` field.
    - `service` string, nullable: Service name used as a special tag in Datadog.
    - `topics` LogTopic[], nullable: The topics this log stream is subscribed to. Omit to keep the current subscription, or pass `null` to subscribe to all topics (including ones added in the future).
    - `logStreamType` 'datadog', required
  - object
    - `url` string, nullable: URL to send logs to.
    - `format` 'json' | 'jsonl'
    - `topics` LogTopic[], nullable: The topics this log stream is subscribed to. Omit to keep the current subscription, or pass `null` to subscribe to all topics (including ones added in the future).
    - `logStreamType` 'webhook', required
  - object
    - `apiKey` string, nullable: Axiom API key for authentication.
    - `datasetName` string, nullable: Name of the dataset in Axiom. This is where the logs will be sent.
    - `attributes` AxiomAttribute[], nullable: Optional list of attributes. These are extra fields and values sent to Axiom in each log event.
      - `key` string, required
      - `value` string, required
    - `ingestUrl` string, nullable: Optional ingest endpoint for Axiom
    - `topics` LogTopic[], nullable: The topics this log stream is subscribed to. Omit to keep the current subscription, or pass `null` to subscribe to all topics (including ones added in the future).
    - `logStreamType` 'axiom', required
  - object
    - `dsn` string, nullable: Sentry Data Source Name (DSN) to route exceptions to.
    - `tags` object, nullable: Tags to add to all events routed to Sentry.
    - `logStreamType` 'sentry', required
  - object
    - `apiKey` string, nullable: PostHog project token.
    - `host` string, nullable: PostHog host URL.
    - `serviceName` string, nullable: OTLP service.name attribute.
    - `topics` LogTopic[], nullable: The topics this log stream is subscribed to. Omit to keep the current subscription, or pass `null` to subscribe to all topics (including ones added in the future).
    - `logStreamType` 'postHogLogs', required
  - object
    - `apiKey` string, nullable: PostHog project token.
    - `host` string, nullable: PostHog host URL.
    - `logStreamType` 'postHogErrorTracking', required

## Response `200`

---

[API](https://skmtc.dev/operatornest/apis/convex-deployment-api.md) · [All operations](https://skmtc.dev/operatornest/apis/convex-deployment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/operatornest/apis/convex-deployment-api/revisions/bd0de6c553a7?raw)