Explore documentation
  1. Welcome to Telemetry👋
  2. Quick start guide
  3. Ingesting data
    1. Vector (Recommended)
    2. OpenTelemetry
    3. Ingesting via HTTP API
    4. Ingesting metrics
    5. Ingesting logs
    6. Migrating to Better Stack
  4. Telemetry API
    1. Getting an API token
    2. Sources
      1. Sources API
      2. Source groups API
        1. List all source groups GET
        2. Get a single source group GET
        3. Create a source group GET
        4. Update a source group PATCH
        5. Remove a source group DELETE
    3. Metrics API
    4. Query API
  5. Using the product
    1. Wide events vs. time series
    2. Transforming ingested data
    3. Querying data
    4. Alerts

Update a source group

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

PATCH https://telemetry.betterstack.com/api/v1/source-groups/{source_group_id}

URL parameters

id
required string

ID of the source group you want to update

Body parameters

name
string

The name of the group that you can see in the dashboard.

sort_index
string

Set sort_index to specify how to sort your source groups.

200

The source group was updated

Response body

{
  "data": {
    "id": "95251342",
    "type": "source_group",
    "attributes": {
      "name": "Backend sources",
      "sort_index": null,
      "created_at": "2025-06-30T17:43:12.192Z",
      "updated_at": "2020-06-30T17:43:12.192Z",
      "team_name": "Test team"
    }
  }
}
404

Your team has no source group with the given ID

Response body

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

Example cURL

Example
curl --request PUT \
  --url https://telemetry.betterstack.com/api/v1/source-groups/123 \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "My renamed source group"
  }'

Previous article

Create a source group

Next article

Remove a source group