Logstreem
Update a dataset
PUT

Update a dataset

Change the description or retention window.

Only description and retention_days are mutable. Name and region are fixed at creation.

Shortening retention deletes data

Blocks outside the new window are dropped on the next daily sweep and cannot be recovered. Mirror first if you might need them — see retention.
PUT/v1/datasets/{name}

Path parameters

namestringrequired

Dataset name or ds_….

Body parameters

descriptionstring

Shown in the console.

retention_daysinteger

1–400.

curl -X PUT https://api.logstreem.com/v1/datasets/{name} \
  -H "Authorization: Bearer $LOGSTREEM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"retention_days":90}'

Responses

200OK
{
  "object": "dataset",
  "id": "ds_9f2c7b1a4d8e0c3f6a5b",
  "name": "api-gateway-prod",
  "description": "Production dataset.",
  "events": 14200000000,
  "fields": 148,
  "retention_days": 90,
  "region": "us-east",
  "created_at": "2026-04-11T12:00:00.000Z"
}
401Unauthorized
{
  "error": {
    "type": "authentication_error",
    "code": "missing_token",
    "message": "No API token provided.",
    "doc_url": "https://logstreem.com/docs/errors#missing_token",
    "request_id": "req_9f3c2a7b41de08c5b2e6"
  }
}
Try itsandbox
PreviousRetrieve a datasetNextDelete a dataset