Explore documentation
  1. Welcome to Logs 👋
  2. Quick start guide
  3. Logs sources
    1. Programming languages
    2. Cloud platforms
    3. Web servers & Load balancers
    4. Operating systems
    5. Databases & Message queues
    6. Containers & Clusters
    7. Logging & Monitoring tools
    8. HTTP REST API
  4. Log Forwarding
    1. Vector (Recommended)
    2. Fluent Bit
    3. Logstash
    4. Fluentd
    5. Filebeat
    6. Syslog
  5. Dashboards
    1. SQL queries
    2. Query variables
    3. Transforming with JavaScript
    4. Alerts
    5. How do we bill for metrics?
  6. API
    1. Get started with Logs API
    2. Sources API
      1. List all existing sources GET
      2. Get a single source GET
      3. Create a source POST
      4. Update a source PATCH
      5. Delete an existing source DELETE
      6. Sources API response parameters
    3. Query API V2
  7. Using Logs
    1. AWS S3-compatible archive
    2. String + JSON format
    3. Formatting logs
    4. Live tail query language
    5. Explore logs with SQL
    6. Querying data in Better Stack

Update a source

Updates an existing source. Send only the parameters you wish to change (e.g. name )

PATCH https://logs.betterstack.com/api/v1/sources/{source_id}

URL parameters

id
required string

ID of the source you want to update

Body parameters

name
string

Source name

ingesting_paused
boolean

Enable or disable ingesting for this source

live_tail_pattern
string

Freeform text template for formatting Live tail output with columns wrapped in {column} brackets. Example: "PID: {message_json.pid} {level} {message}"

logs_retention
integer

Data retention for logs in days. There might be additional charges for longer retention.

metrics_retention
integer

Data retention for metrics in days. There might be additional charges for longer retention.

200

The source was updated

Response body

{
  "id": "95",
  "type": "source",
  "attributes": {
    "team_id": 123,
    "name": "Nginx",
    "table_name": "nginx",
    "platform": "nginx",
    "token": "FczKcxEhjEDE58dBX7XaeX1q",
    "ingesting_paused": false,
    "logs_retention": 7,
    "metrics_retention": 14,
    "live_tail_pattern": "{level} {host} {nginx.status} {nginx.method} {nginx.host} {nginx.path} {nginx.client} {nginx.agent} {message}",
    "created_at": "2021-05-27T12:30:41.695Z",
    "updated_at": "2021-06-11T14:00:50.756Z"
  }
}
404

Your team has no source with the given ID

Response body

{
  "errors": "Resource with provided ID was not found"
}
422

Validation failed

Response body

{
  "errors": "Your plan doesn't support custom retention",
  "invalid_attributes": [
    "logs_retention",
    "metrics_retention"
  ]
}

Previous article

Create a source

Next article

Delete an existing source