---
title: "Update endpoint"
method: PUT
path: "/api/e2/endpoints/{id}"
tags: ["Endpoints"]
---

# Update endpoint

`PUT /api/e2/endpoints/{id}`

Update an existing endpoint's name, description, active status, config, or webhook format

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `description` string
  - `isActive` boolean
  - `config` union
    - object
      - `url` string, required
      - `timeout` number
      - `retryAttempts` number
      - `headers` object — Custom headers to include with webhook requests
    - object
      - `forwardTo` string, email, required
      - `includeAttachments` boolean
      - `subjectPrefix` string
      - `fromAddress` string, email
      - `senderName` string
      - `preserveHeaders` boolean
    - object
      - `emails` string[], required
      - `includeAttachments` boolean
      - `subjectPrefix` string
      - `fromAddress` string, email
      - `senderName` string
      - `preserveHeaders` boolean
  - `webhookFormat` 'inbound' | 'discord' | 'slack'

## Response `200`

Response for status 200

- object
  - `id` string, required
  - `name` string, required
  - `type` 'webhook' | 'email' | 'email_group', required
  - `config` unknown, required
  - `isActive` boolean, required
  - `description` string, nullable, required
  - `userId` string, required
  - `createdAt` string, nullable, required
  - `updatedAt` string, nullable, required
  - `groupEmails` string[], nullable, required

## Other responses

- `400` — Response for status 400
- `401` — Response for status 401
- `404` — Response for status 404
- `500` — Response for status 500

---

[API](https://skmtc.dev/stainless-api/apis/inbound-email-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/inbound-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stainless-api/inbound-email-api/revisions/e279d3cb940b/schema)