---
title: "PATCH /api/v1/agents/{agentId}/sources/{sourceId}"
method: PATCH
path: "/api/v1/agents/{agentId}/sources/{sourceId}"
tags: ["agentSources"]
---

# PATCH /api/v1/agents/{agentId}/sources/{sourceId}

`PATCH /api/v1/agents/{agentId}/sources/{sourceId}`

## Request

- Base URL: `https://api.clerkchat.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clerkchat.co/api/v1/agents/{agentId}/sources/{sourceId}`
- Auth: none required

## Path parameters

- `agentId` string, required
- `sourceId` string, required

## Request body

- union
  - object
    - `type` 'file', required
    - `title` string, required
  - object
    - `type` 'website', required
    - `title` string, required
    - `websiteUrl` string, required
    - `websiteMode` 'page' | 'site', required
    - `retrainEnabled` boolean, nullable
  - object
    - `type` 'text', required
    - `title` string, required
    - `body` string, required
  - object
    - `type` 'qa', required
    - `title` string, required
    - `question` string, required
    - `answer` string, required

## Response `200`

Success

- union
  - object
    - `id` string, required
    - `organizationId` string, required
    - `agentId` string, required
    - `title` string, required
    - `status` 'draft' | 'indexing' | 'ready' | 'failed' | 'archived', required
    - `errorCode` string, nullable, required
    - `errorMessage` string, nullable, required
    - `createdByUserId` string, required
    - `createdAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `updatedAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `type` 'website', required
    - `websiteUrl` string, required
    - `websiteMode` 'page' | 'site', required
    - `retrainEnabled` boolean, required
  - object
    - `id` string, required
    - `organizationId` string, required
    - `agentId` string, required
    - `title` string, required
    - `status` 'draft' | 'indexing' | 'ready' | 'failed' | 'archived', required
    - `errorCode` string, nullable, required
    - `errorMessage` string, nullable, required
    - `createdByUserId` string, required
    - `createdAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `updatedAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `type` 'text', required
    - `body` string, required
  - object
    - `id` string, required
    - `organizationId` string, required
    - `agentId` string, required
    - `title` string, required
    - `status` 'draft' | 'indexing' | 'ready' | 'failed' | 'archived', required
    - `errorCode` string, nullable, required
    - `errorMessage` string, nullable, required
    - `createdByUserId` string, required
    - `createdAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `updatedAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `type` 'qa', required
    - `question` string, required
    - `answer` string, required
  - object
    - `id` string, required
    - `organizationId` string, required
    - `agentId` string, required
    - `title` string, required
    - `status` 'draft' | 'indexing' | 'ready' | 'failed' | 'archived', required
    - `errorCode` string, nullable, required
    - `errorMessage` string, nullable, required
    - `createdByUserId` string, required
    - `createdAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `updatedAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `type` 'file', required
    - `fileName` string, required
    - `fileKind` 'pdf' | 'txt' | 'md' | 'csv' | 'tsv' | 'json' | 'xls' | 'xlsx', required
    - `fileContentType` string, required
    - `fileSizeBytes` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `fileRetrievalMode` 'text' | 'structured', required
    - `fileSchemaJson` string, nullable, required
    - `notionPageId` string, nullable, required
    - `notionPageUrl` string, nullable, required
    - `fileOriginUrl` string, nullable, required

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: NotFound
- `503`: PersistenceUnavailable

---

[API](https://skmtc.dev/clerkchat/apis/clerk-chat-api.md) · [All operations](https://skmtc.dev/clerkchat/apis/clerk-chat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clerkchat/apis/clerk-chat-api/revisions/cc318e39e1d0?raw)