Explore documentation
  1. Welcome to Errors 👋
  2. Collecting errors
    1. Integrating using an AI prompt
    2. Sentry SDK
  3. Using the product
    1. Exception grouping
    2. Fix with AI
    3. Releases
  4. Integrations
    1. Reporting incidents
    2. Slack
    3. Microsoft Teams
    4. Linear
    5. Jira
  5. Errors API
    1. Getting an API token
    2. Applications API
    3. Application groups API
      1. List all groups GET
      2. Get a single group GET
      3. Create a group POST
      4. Update a group PUT
      5. Remove a group DELETE
      6. List applications in a group GET

Update a group

Updates an existing application group. Send only the parameters you wish to change.

PUT https://errors.betterstack.com/api/v1/application-groups/{id}

URL parameters

id
required string

The ID of the application group to update.

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
required string

application/json

Body parameters

name
string

New application group name. Must be unique within your team.

200

Returns the updated application group.

Response body

{
  "data": {
    "id": "5678",
    "type": "application_group",
    "attributes": {
      "name": "updated-production-apps",
      "created_at": "2025-01-15T10:25:00.000Z",
      "updated_at": "2025-01-15T10:30:00.000Z",
      "sort_index": null,
      "team_name": "example-team"
    }
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
404

Not Found

Response body

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

Unprocessable Entity - Validation Errors

Response body

{
  "errors": "Validation errors",
  "invalid_attributes": {
    "name": [
      "already taken"
    ]
  }
}

Example cURL

Example
curl --request PUT \
  --url https://errors.betterstack.com/api/v1/application-groups/5678 \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "updated-production-apps"
  }'

Previous article

Create a group

Next article

Remove a group