Получение и удаление чатов, файлов и проектов

Конечные точки на этой странице предоставляют проверяющим по соответствию требованиям доступ к содержимому чатов claude.ai, загруженным файлам, проектам и вложениям проектов. Они поддерживают экспорт для «eDiscovery» (электронное обнаружение данных), применение политик «data loss prevention» (предотвращение утечки данных), или DLP, а также обработку запросов на удаление учётных записей. Содержимое хранится столько, сколько позволяет политика хранения вашей организации. Чаты, которые пользователь мягко удалил в claude.ai, остаются видимыми через Compliance API с заполненным полем deleted_at; чаты, которые были жёстко удалены (через сам Compliance API или после истечения периода хранения организации), получить невозможно.

Обе области действия предоставляются только для ключей Compliance Access Key (sk-ant-api01-...), созданных в claude.ai; см. Получение доступа к Compliance API, чтобы создать такой ключ. Область действия read:compliance_user_data охватывает получение данных; delete:compliance_user_data требуется только для конечных точек удаления. Конечные точки чатов, файлов, проектов и вложений недоступны для ключей Admin API (sk-ant-admin01-...); вызовы, аутентифицированные с помощью ключа Admin API, возвращают 403 Forbidden.

Конечные точки на этой странице используют два способа пагинации; полное описание см. в разделе Пагинация результатов. В каждом разделе указано, какая схема применяется.

Получение чатов и сообщений

Используйте Список чатов, чтобы постранично просмотреть метаданные чатов, а затем Получение сообщений чата, чтобы получить полное содержимое сообщений одного чата.

Конечная точка списка чатов требует хотя бы одного значения user_ids[] (и принимает до 10 в одном запросе), поэтому сначала перечислите идентификаторы пользователей с помощью Списка пользователей организации, а затем получите список чатов для каждого пользователя или для каждой группы пользователей. Следующий запрос выводит список чатов, принадлежащих конкретному пользователю, начиная с заданной даты.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/chats" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "user_ids[]=user_01XyDMpzjS89pFZXqSFUBDr6" \
  --data-urlencode "organization_ids[]=91012d09-e48b-438e-a489-1bebfd8fa6f9" \
  --data-urlencode "created_at.gte=2025-06-01T00:00:00Z" \
  --data-urlencode "limit=100"

{
  "data": [
    {
      "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
      "name": "Product Requirements Discussion",
      "created_at": "2026-04-10T08:09:10Z",
      "updated_at": "2026-04-10T09:10:11Z",
      "deleted_at": null,
      "href": "https://claude.ai/chat/abcdef01-2345-6789-abcd-ef0123456789",
      "model": "claude-opus-4-8",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
      "user": {
        "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
        "email_address": "[email protected]"
      }
    }
  ],
  "has_more": true,
  "first_id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "last_id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja"
}

Список чатов возвращает только метаданные. Полный список фильтров см. в разделе Список чатов; помимо обязательного user_ids[], границы updated_at.* полезны для инкрементальной проверки чатов, изменившихся с момента предыдущего экспорта.

Результаты чатов сортируются по created_at по возрастанию (сначала самые старые), при совпадении значений — по id. Пагинация использует те же курсорные поля first_id/last_id/has_more, что и в разделе Пагинация результатов; передавайте last_id как after_id, чтобы двигаться вперёд к более новым чатам, или first_id как before_id, чтобы двигаться назад к более старым.

Чтобы получить фактическое содержимое чата, прикреплённые файлы и встроенные артефакты (структурированные документы, которые Claude генерирует внутри чата), выполните запрос к конечной точке сообщений для каждого идентификатора чата:

chat_id="claude_chat_01H5CWunD7RpVJ5bHa8RCkja"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/chats/$chat_id/messages" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

Конечная точка сообщений возвращает метаданные чата и массив chat_messages, отсортированный по created_at. Если параметр limit не указан, полный набор сообщений возвращается в одном ответе; передавайте limit, after_id или before_id, чтобы постранично просматривать очень длинные чаты. Конечная точка также принимает границы диапазонов created_at.* и updated_at.* (gt, gte, lt, lte) и параметр order (asc или desc). Полный список параметров см. в разделе Получение сообщений чата. Для сообщений пользователя created_at — это время отправки сообщения; для сообщений ассистента — время, когда Claude завершил генерацию сообщения. Каждое сообщение содержит свой текст и, при наличии, любые загруженные файлы (обычно в сообщениях пользователя), любые файлы, сгенерированные инструментами, и любые артефакты, которые ассистент создал или обновил (обычно в сообщениях ассистента):

{
  "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "name": "Product Requirements Discussion",
  "created_at": "2026-04-10T08:09:10Z",
  "updated_at": "2026-04-10T09:10:11Z",
  "deleted_at": null,
  "href": "https://claude.ai/chat/abcdef01-2345-6789-abcd-ef0123456789",
  "model": "claude-opus-4-8",
  "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
  "user": {
    "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
    "email_address": "[email protected]"
  },
  "chat_messages": [
    {
      "id": "claude_chat_msg_01VnBPkLmtj7YdW5QrXKEA8c",
      "role": "user",
      "created_at": "2026-04-10T08:09:10Z",
      "content": [
        {
          "type": "text",
          "text": "Can you help me draft requirements for our new dashboard feature?"
        }
      ],
      "files": [
        {
          "id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
          "filename": "dashboard_mockup_v1.pdf",
          "mime_type": "application/pdf"
        }
      ]
    },
    {
      "id": "claude_chat_msg_01M8tFcHwbQ2kY6NpEjRZv4D",
      "role": "assistant",
      "created_at": "2026-04-10T08:09:11Z",
      "content": [
        {
          "type": "text",
          "text": "I'd be happy to help you draft requirements for your dashboard feature..."
        }
      ],
      "generated_files": [
        {
          "id": "claude_gen_file_01TbR8wAcCeFhJkLnPqStUvX",
          "filename": "requirements_summary.csv",
          "mime_type": "text/csv"
        }
      ],
      "artifacts": [
        {
          "id": "claude_artifact_01HqRsTuVwXyZa2BcDeFgH4J",
          "version_id": "claude_artifact_version_01KmNpQrSt3UvWxYz5AbCdEfG",
          "title": "Dashboard Requirements Draft",
          "artifact_type": "text/markdown"
        }
      ]
    }
  ],
  "has_more": false,
  "first_id": "eyJtc2dfdXVpZCI6ICIwZjcwYjA2Ni0uLi4ifQ==",
  "last_id": "eyJtc2dfdXVpZCI6ICJhNGUwYjE3Mi0uLi4ifQ=="
}

Поля files, generated_files и artifacts могут иметь значение null в конкретном сообщении. files — это бинарные загрузки (PDF, изображения, электронные таблицы), которые пользователь прикрепил к сообщению. generated_files — это бинарные файлы, которые ассистент создал в ходе разговора посредством использования инструментов (например, PDF, электронные таблицы или презентации). artifacts — это версионированные документы (например, код или markdown), которые ассистент сгенерировал или обновил в своём ответе; артефакт может пересматриваться на протяжении нескольких ходов ассистента в одном чате, и каждая ревизия отображается как новый version_id под тем же id артефакта. Передайте id каждой записи (или version_id для артефактов) в соответствующую конечную точку содержимого в разделе Получение файлов и артефактов, чтобы скачать его.

Получение файлов и артефактов

Файлы и артефакты скачиваются по идентификатору, а не перечисляются независимо. Идентификаторы поступают из конечной точки сообщений чата в разделе Получение чатов и сообщений (массивы files, generated_files и artifacts в каждом сообщении) или, для загрузок на уровне проекта, из конечной точки вложений проекта.

Выберите конечную точку, соответствующую типу вашего идентификатора и нужным данным. Одна и та же конечная точка содержимого файла обслуживает как файлы чатов, так и файлы проектов.

Конечная точка содержимого файла передаёт исходную загрузку потоком как бинарный ответ по частям со следующими заголовками:

• Content-Disposition: attachment; filename*=utf-8''<percent-encoded filename> содержит исходное имя загруженного файла в расширенной форме RFC 5987. Расширенная форма используется для всех имён файлов, а не только для содержащих символы вне ASCII.
• Content-Type содержит MIME-тип загрузки.
• Content-MD5 содержит MD5-дайджест файла, закодированный в base64 согласно RFC 1864.
• Transfer-Encoding: chunked устанавливается всегда.

file_id="claude_file_01UaT9wBcDfGhJkLmNpQrSv7"

curl --fail-with-body -sS -OJ \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  "https://api.anthropic.com/v1/compliance/apps/chats/files/$file_id/content"

Флаги -OJ указывают curl сохранить ответ под именем файла из Content-Disposition, то есть под исходным именем файла, загруженного пользователем.

Конечная точка содержимого артефакта возвращает текстовое тело одной версии артефакта. Передавайте version_id из одной из записей массива artifacts в сообщении ассистента, а не стабильный id артефакта. Каждая новая версия артефакта имеет собственный version_id, и Compliance API отдаёт точные байты этой версии.

Получение проектов и вложений

Проекты объединяют связанные чаты вместе с пользовательскими инструкциями, содержимым базы знаний и прикреплёнными файлами или текстовыми документами. Compliance API предоставляет метаданные проектов, сведения о проектах и список вложений, принадлежащих проекту.

• Список проектов
• Получение сведений о проекте
• Список вложений проекта
• Получение содержимого документа проекта

Результаты проектов сортируются по дате создания по возрастанию. Результаты вложений сортируются по created_at по возрастанию, при совпадении значений — по id. Ответы списка проектов и списка вложений используют для пагинации непрозрачный токен страницы next_page вместо курсоров first_id/last_id, применяемых для чатов и Activity Feed. Передавайте токен обратно как параметр запроса page в следующем запросе.

Файлы проекта и документы проекта

Вложение проекта имеет одну из двух различных форм, определяемых дискриминатором type в каждой записи:

Записи с type, равным project_file, — это бинарные загрузки (PDF, изображения, электронные таблицы), идентификаторы которых начинаются с claude_file_; скачивайте их с помощью Скачать содержимое файла. Записи с type, равным project_doc, — это текстовые документы (всегда text/plain), идентификаторы которых начинаются с claude_proj_doc_; получайте их с помощью Получить содержимое документа проекта.

Потребитель, обходящий список вложений, должен ветвиться по полю type и вызывать соответствующую конечную точку содержимого для каждой записи. Следующий запрос выводит одну страницу вложений; для пагинации передавайте next_page обратно как параметр page, пока has_more не станет false.

project_id="claude_proj_01KGp4eZNug9ri4kE35RSppq"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/projects/$project_id/attachments" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
      "created_at": "2026-04-10T08:09:10Z",
      "filename": "dashboard_mockup_v1.pdf",
      "mime_type": "application/pdf",
      "type": "project_file"
    },
    {
      "id": "claude_proj_doc_01YnT8sBcWvUtXzQpMkRfDgH",
      "created_at": "2026-04-10T08:09:11Z",
      "filename": "requirements.md",
      "mime_type": "text/plain",
      "type": "project_doc"
    }
  ],
  "has_more": false,
  "next_page": null
}

Удаление содержимого

Compliance API предоставляет конечные точки жёсткого удаления для чатов, файлов, документов проектов и целых проектов. Жёстко удалённый чат невозможно восстановить, и после этого он перестаёт отображаться в ответах списков (тогда как чат, мягко удалённый из claude.ai, по-прежнему отображается с заполненным полем deleted_at).

• Удалить чат: также удаляет сообщения чата и все файлы, прикреплённые к этим сообщениям.
• Удалить файл: обрабатывает как файлы чатов, так и файлы проектов.
• Удалить документ проекта: удаляет один документ проекта по идентификатору.
• Удалить проект: см. Отсоединение чатов перед удалением проекта.

Все четыре конечные точки требуют области действия delete:compliance_user_data, которая предоставляется отдельно от области чтения при создании ключа Compliance Access Key.

Следующий запрос удаляет один чат. Тот же шаблон применяется к другим конечным точкам удаления; меняется только URL.

# ПРЕДУПРЕЖДЕНИЕ: эта операция БЕЗВОЗВРАТНО удаляет чат, все его сообщения
# и все прикреплённые файлы. Удаление происходит немедленно и не может быть отменено.
# Требуется область доступа `delete:compliance_user_data`, которая выдаётся отдельно
# от `read:compliance_user_data` при создании ключа доступа для соответствия требованиям.
# Убедитесь, что у вас есть явное разрешение, прежде чем выполнять это.

chat_id="claude_chat_01H5CWunD7RpVJ5bHa8RCkja"

curl --fail-with-body -sS -X DELETE \
  "https://api.anthropic.com/v1/compliance/apps/chats/$chat_id" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "type": "claude_chat_deleted"
}

Каждое успешное удаление возвращает небольшой конверт подтверждения с полями id и дискриминатором type. Конечная точка чата возвращает claude_chat_deleted; проверяйте поле type, прежде чем считать удаление подтверждённым. Точное значение type, возвращаемое другими конечными точками, см. в схеме ответа на странице справочника API каждой конечной точки удаления.

Отсоединение чатов перед удалением проекта

Проект нельзя удалить, пока к нему прикреплены какие-либо чаты. API возвращает код 409 со следующим телом:

{
  "error": {
    "type": "conflict_error",
    "message": "The \"claude_proj_01KGp4eZNug9ri4kE35RSppq\" project cannot be deleted as it has chats attached to it. Delete or detach all chats, and try deleting the project again."
  }
}

Чтобы решить эту проблему, получите список чатов проекта с помощью GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id} (конечная точка списка чатов требует хотя бы одного значения user_ids[]; перечислите идентификаторы через Список пользователей организации), удалите каждый из них с помощью DELETE /v1/compliance/apps/chats/{claude_chat_id} (или переместите его из проекта в claude.ai), а затем повторите удаление проекта.

Дальнейшие шаги