Update an existing custom integration.

PUT /api/0/sentry-apps/{sentry_app_id_or_slug}/

Update an existing custom integration.

Path Parameters

sentry_app_id_or_slug (string)
REQUIRED

The ID or slug of the custom integration.

Body Parameters

name (string)
REQUIRED

The name of the custom integration.

scopes (array(string))
REQUIRED

The custom integration's permission scopes for API access.

author (string)

The custom integration's author.

events (array(string))

Webhook events the custom integration is subscribed to.

schema (object)

The UI components schema, used to render the custom integration's configuration UI elements. See our schema docs for more information.

webhookUrl (string)

The webhook destination URL.

redirectUrl (string)

The post-installation redirect URL.

isInternal (boolean)

Whether or not the integration is internal only. False means the integration is public.

isAlertable (boolean)

Marks whether or not the custom integration can be used in an alert rule.

overview (string)

The custom integration's description.

verifyInstall (boolean)

Whether or not an installation of the custom integration should be verified.

allowedOrigins (array(string))

The list of allowed origins for CORS.

Scopes

<auth_token> requires one of the following scopes:
  • org:admin
  • org:write
Copied
curl https://sentry.io/api/0/sentry-apps/{sentry_app_id_or_slug}/ \
 -H 'Authorization: Bearer <auth_token>' \
 -X PUT \
 -H 'Content-Type: application/json' \
 -d '{}'
RESPONSESCHEMA
Copied
{
  "allowedOrigins": [],
  "author": "ACME Corp",
  "avatars": {
    "avatarType": "avatar",
    "avatarUuid": "6c25b771-a576-4c18-a1c3-ab059c1d42ba",
    "avatarUrl": "https://example.com/avatar.png",
    "color": false
  },
  "events": [
    "issue"
  ],
  "isAlertable": false,
  "metadata": "",
  "name": "ACME Corp Integration",
  "overview": null,
  "popularity": 27,
  "redirectUrl": null,
  "featureData": [],
  "schema": "",
  "scopes": [
    "event:read",
    "org:read"
  ],
  "slug": "acme-corp-integration",
  "status": "unpublished",
  "uuid": "77cebea3-019e-484d-8673-6c3969698827",
  "verifyInstall": true,
  "webhookUrl": "https://example.com/webhook",
  "clientId": "ed06141686bb60102d878c607eff449fa9907fa7a8cb70f0d337a8fb0b6566c3",
  "clientSecret": "**********",
  "owner": {
    "id": 42,
    "slug": "acme-corp"
  }
}
Was this helpful?