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
      1. List all applications GET
      2. Get a single application GET
      3. Create an application POST
      4. Update an application PUT
      5. Remove an application DELETE
    3. Application groups API

Update an application

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

PUT https://errors.betterstack.com/api/v1/applications/{id}

URL parameters

id
required string

The ID of the application to update.

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
required string

application/json

Body parameters

name
string

New application name. Must be unique within your team.

errors_retention
integer

New error data retention period in days.

ingesting_paused
boolean

Set to true to pause error ingestion, false to resume.

200

Returns the updated application.

Response body

{
  "data": {
    "id": "1234",
    "type": "application",
    "attributes": {
      "application_group_id": 5678,
      "team_id": 123456,
      "team_name": "example-team",
      "name": "updated-web-app",
      "table_name": "updated_web_app",
      "token": "abc123def456ghi789",
      "ingesting_paused": false,
      "ingesting_host": "s1234.us-east-9.betterstackdata.com",
      "created_at": "2025-01-15T10:30:00.000Z",
      "updated_at": "2025-01-15T10:35:00.000Z",
      "errors_retention": 90,
      "data_region": "us-east-9",
      "custom_bucket": null
    }
  }
}
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/applications/1234 \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "updated-web-app",
    "ingesting_paused": false
  }'

Previous article

Create an application

Next article

Remove an application