Explore documentation
  1. Welcome to Errors 👋
    1. JavaScript tag
  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. Uploading source maps
  4. Integrations
    1. Reporting incidents
    2. Slack
    3. Microsoft Teams
    4. Linear
    5. Jira
    6. GitHub
  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 PATCH
      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.

PATCH 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.

github_repository_name
string

The full name of a GitHub repository (e.g., owner/repo) to connect to the application. The repository must be connected to your team via the GitHub integration first. To disconnect a repository, provide an empty string or null.

code_mapping_stack_root
string

The absolute path to the root of the stack trace on your server (e.g., /usr/src/app/). This is used to resolve source code paths for AI-assisted debugging.

code_mapping_source_root
string

The relative path from your project's root to the source code being deployed (e.g., apps/backend/). This is used to resolve source code paths for AI-assisted debugging.

200

Returns the updated application.

Response body

{
  "data": {
    "id": "1234",
    "type": "application",
    "attributes": {
      "application_group_id": 5678,
      "correlate_with_source_id": "9876",
      "github_repository_name": "better-stack/my-app",
      "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,
      "code_mapping_stack_root": "/usr/src/app/",
      "code_mapping_source_root": "apps/backend/"
    }
  }
}
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"
    ]
  }
}
422

Unprocessable Entity - GitHub Repository Not Connected

Response body

{
  "errors": {
    "github_repository_name": [
      "GitHub repository 'owner/repo' isn't connected to this team. Connect it first at https://errors.betterstack.com/team/t123/integrations/github/edit"
    ]
  }
}

Example cURL

Example
curl --request PATCH \
  --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,
    "github_repository_name": "better-stack/my-app",
    "code_mapping_stack_root": "/usr/src/app/",
    "code_mapping_source_root": "apps/backend/"
  }'


Previous article

Create an application

Next article

Remove an application