---
title: "PATCH /api/im/outbound/{id}"
method: PATCH
path: "/api/im/outbound/{id}"
tags: ["Im"]
---

# PATCH /api/im/outbound/{id}

`PATCH /api/im/outbound/{id}`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/im/outbound/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `teamId` integer, nullable
  - `filters` object
    - `teams` integer[]: Only incidents of these teams.
    - `severities` string[]
    - `event_kinds` string[]: Default all; jira defaults to incident_created.
  - `config` object: Overlay on the stored config; blank secrets keep the stored value.
    - `webhookUrl` string
    - `bearerToken` string: webhook only.
    - `headers` object: webhook only.
    - `email` string: jira.
    - `apiToken` string: jira.
    - `baseUrl` string: jira, https only.
    - `projectKey` string: jira.
    - `routingKey` string: pagerduty_v2.
    - `apiKey` string: opsgenie.
  - `isActive` boolean

## Response `200`

Successful response

- object
  - `id` integer, required
  - `organizationId` integer, required
  - `teamId` integer, nullable, required
  - `type` 'slack' | 'teams' | 'discord' | 'jira' | 'pagerduty_v2' | 'opsgenie' | 'webhook', required
  - `name` string, required
  - `config` object, required
    - `webhookUrl` unknown
    - `hasWebhookUrl` boolean
    - `bearerToken` unknown
    - `hasBearerToken` boolean
    - `headers` unknown
    - `hasHeaders` boolean
    - `email` string
    - `apiToken` unknown
    - `hasApiToken` boolean
    - `baseUrl` string
    - `projectKey` string
    - `routingKey` unknown
    - `hasRoutingKey` boolean
    - `apiKey` unknown
    - `hasApiKey` boolean
  - `filters` object, required
    - `teams` integer[]: Only incidents of these teams.
    - `severities` string[]
    - `event_kinds` string[]: Default all; jira defaults to incident_created.
  - `isActive` boolean, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `404`: No such resource, or not visible to this token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)