Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. OpenTelemetry
    3. Vector
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Grafana
    7. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
      1. Sources API
      2. Collectors API
      3. Collector metrics targets API
      4. Metrics API
      5. Source groups API
        1. List all source groups GET
        2. Get a single source group GET
        3. List sources in group GET
        4. Create a source group GET
        5. Update a source group PATCH
        6. Remove a source group DELETE
    3. Dashboards
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
    8. Usage API ↗
  7. Alternative to
    1. Lightstep

Update a source group

Updates an existing source group. Always send name, even when you only change sort_index.

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

URL parameters

id
required string

ID of the source group you want to update

Body parameters

name
required string

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

sort_index
integer

The position of the group in your list of source groups, lower values first.

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": "2025-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 PATCH \
  --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