---
title: "Update a source"
method: PUT
path: "/agency/source/{sourceId}"
tags: ["Source"]
---

# Update a source

`PUT /agency/source/{sourceId}`

Updates fields in a source.

Only non-null fields are updated. Any missing or null field is ignored.

## Path parameters

- `sourceId` string, required

## Request body

- UpdateSourceInput
  - `name` string, nullable
  - `autoShutoff` boolean, nullable
  - `gracefulGoodbye` boolean, nullable
  - `isAvailabilityContactTimezone` boolean, nullable
  - `botRespondWindows` BotSourceAvailabilityDto[], nullable
    - `dayOfWeekUtc` string, nullable
    - `startTimeUtc` string, nullable
    - `duration` string, nullable
    - `channel` string, nullable
  - `isBotRespondWindowsQuietHours` boolean, nullable
  - `respondWindows` SourceAvailabilityDto[], nullable
    - `dayOfWeekUtc` string, nullable
    - `startTimeUtc` string, nullable
    - `duration` string, nullable
  - `doNotRespondWindows` SourceDoNotRespondWindowDto[], nullable
    - `start` string, date-time
    - `end` string, date-time
  - `summarizeAttachments` boolean, nullable
  - `respondToReactions` boolean, nullable
  - `markConversationsAsUnread` boolean, nullable
  - `wallet` UpdateSourceWalletInput
    - `reBilling` boolean, nullable
    - `autoRefill` boolean, nullable
    - `topUpAmount` integer, nullable
    - `refillThreshold` integer, nullable
    - `responseUnitCostOverride` string, nullable
    - `storageUnitCostOverride` string, nullable
    - `userUnitCostOverride` string, nullable
    - `stripeCustomerId` string, nullable
  - `accountsWithAccess` string[], nullable
  - `webhookCallback` string, nullable
  - `scriptDomainAllowList` string[], nullable
  - `hubSpotOwnerId` string, nullable
  - `timezone` string, nullable

## Response `200`

Success

- SourceDto
  - `agencyId` string, nullable
  - `sourceId` string, nullable
  - `name` string, nullable
  - `category` string, nullable
  - `key` string, nullable
  - `accessToken` string, nullable
  - `address` string, nullable
  - `connected` boolean
  - `autoShutoff` boolean
  - `gracefulGoodbye` boolean
  - `bots` SourceBotDto[], nullable
    - `id` string, nullable
    - `botName` string, nullable
    - `tags` ContactTag[], nullable
      - `name` string, nullable
      - `approveDeny` boolean
      - `id` string, nullable
    - `tagFilterConfig` TagFilterConfig
      - `operator` string, nullable
      - `groups` TagFilterGroup[], nullable
        - `operator` string, nullable
        - `rules` TagFilterRule[], nullable
          - `tagName` string, nullable
          - `tagId` string, nullable
          - `condition` string, nullable
    - `channels` string[], nullable
    - `personaNameOverride` string, nullable
    - `enabled` boolean
  - `accountsWithAccess` string[], nullable
  - `isAvailabilityContactTimezone` boolean
  - `respondWindows` SourceAvailabilityDto[], nullable
    - `dayOfWeekUtc` string, nullable
    - `startTimeUtc` string, nullable
    - `duration` string, nullable
  - `doNotRespondWindows` SourceDoNotRespondWindowDto[], nullable
    - `start` string, date-time
    - `end` string, date-time
  - `botRespondWindows` BotSourceAvailabilityDto[], nullable
    - `dayOfWeekUtc` string, nullable
    - `startTimeUtc` string, nullable
    - `duration` string, nullable
    - `channel` string, nullable
  - `isBotRespondWindowsQuietHours` boolean
  - `summarizeAttachments` boolean
  - `respondToReactions` boolean
  - `markConversationAsUnread` boolean
  - `webhookCallback` string, nullable
  - `scriptInstalled` boolean
  - `scriptLastSeenAt` string, date-time, nullable
  - `scriptLastSeenDomain` string, nullable
  - `scriptLastSeenEndpoint` string, nullable
  - `scriptDomainAllowList` string[], nullable
  - `wallet` SourceWalletDto
    - `reBilling` boolean
    - `autoRefill` boolean
    - `topUpAmount` integer
    - `refillThreshold` integer
    - `stripeCustomerId` string, nullable
    - `currency` string, nullable
    - `responseUnitCostOverride` string, nullable
    - `storageUnitCostOverride` string, nullable
    - `userUnitCostOverride` string, nullable
  - `hubSpotOwnerId` string, nullable

## Other responses

- `400` — Bad Request

---

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