Справочник API

Sam AI

Sam AI пишет ваши ответы в диалогах кампаний. Он читает инструкции и файлы на трёх уровнях. Аккаунт X рассказывает о вашем бизнесе, персона о том, как продавать этому типу покупателей, а диалог о конкретном лиде. Если два уровня расходятся, побеждает более точный.

Диалог работает в одном из трёх режимов. off оставляет его вам. draft соответствует режиму «Полуавто», Sam AI пишет подсказку, а отправляете её вы. auto позволяет Sam AI самому отправлять ответы с вашего аккаунта X. Персона задаёт режим своих диалогов, а диалог может задать собственный режим или взять режим персоны через inherit.

Sam AI работает на тарифах Business и Enterprise и только в запущенных кампаниях. На тарифе ниже Business он ничего не пишет, ни в draft, ни в auto. Каждый ответ Sam AI при отправке списывает 30 кредитов, сколько бы сообщений в нём ни было. Неотправленная подсказка бесплатна, но Sam AI пишет её, только если баланса хватает на один ответ. Новые подсказки, отправленные Sam AI ответы и передачи диалога вам также приходят вебхуками sam.suggestion.ready, sam.reply.sent и sam.handoff.

Эндпоинты

GET/v1/account/sam
PATCH/v1/account/sam
GET/v1/personas/:persona_id/sam
PATCH/v1/personas/:persona_id/sam
GET/v1/conversations/:conversation_id/sam
PATCH/v1/conversations/:conversation_id/sam
POST/v1/account/sam/files
DELETE/v1/account/sam/files/:file_id
POST/v1/personas/:persona_id/sam/files
DELETE/v1/personas/:persona_id/sam/files/:file_id
POST/v1/conversations/:conversation_id/sam/files
DELETE/v1/conversations/:conversation_id/sam/files/:file_id

Объект Sam AI аккаунта

Sam AI для всего аккаунта X, его переключатель и то, что он знает о вашем бизнесе.

Атрибуты

objectstring
Всегда account_sam.
account_idstring
ID аккаунта X, как в объекте аккаунта.
enabledboolean
false, если Sam AI выключен во всех диалогах аккаунта X, независимо от их режима.
instructionsstring
Описание вашего бизнеса, которое Sam AI читает в каждом диалоге, например ваше предложение, цены, гарантия и ссылки. До 3 000 символов.
filesмассив objects
Файлы, которые Sam AI читает в каждом диалоге, в виде объектов файла Sam AI.

Объект Sam AI аккаунта

{
  "object": "account_sam",
  "account_id": "a9PzK2vRtM",
  "enabled": true,
  "instructions": "Acme lets creators charge for their Discord. 5 percent a sale, no monthly fee, payouts every week. Sign up at https://acme.com/start.",
  "files": [
    {
      "id": "sf_4c1e9a07d2b35f68e190",
      "object": "sam_file",
      "name": "Pricing and payouts.pdf",
      "size": 182344,
      "mime_type": "application/pdf",
      "url": "https://upcdn.io/W142hYH/raw/uploads/GemleadSamFiles/api/7f3a9c21e5b04d18/Pricing-and-payouts.pdf"
    }
  ]
}

Получение Sam AI аккаунта

GET/v1/account/samПраво readMCPget_sam_settings

Возвращает, включён ли Sam AI для аккаунта X, описание бизнеса и файлы аккаунта.

Возвращает

Объект Sam AI аккаунта.

GET/v1/account/sam

curl https://gemlead.ai/api/v1/account/sam \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Ответ200

{
  "object": "account_sam",
  "account_id": "a9PzK2vRtM",
  "enabled": true,
  "instructions": "Acme lets creators charge for their Discord. 5 percent a sale, no monthly fee, payouts every week. Sign up at https://acme.com/start.",
  "files": [
    {
      "id": "sf_4c1e9a07d2b35f68e190",
      "object": "sam_file",
      "name": "Pricing and payouts.pdf",
      "size": 182344,
      "mime_type": "application/pdf",
      "url": "https://upcdn.io/W142hYH/raw/uploads/GemleadSamFiles/api/7f3a9c21e5b04d18/Pricing-and-payouts.pdf"
    }
  ]
}

Изменение Sam AI аккаунта

PATCH/v1/account/samПраво writeMCPupdate_sam_settings

Включает или выключает Sam AI для всего аккаунта X или меняет описание бизнеса, которое читается в каждом диалоге. Меняются только переданные поля.

Параметры тела

enabledboolean
false выключает Sam AI во всех диалогах аккаунта X, true снова включает его.
instructionsstring
Описание вашего бизнеса, до 3 000 символов. Пустая строка стирает его.

Возвращает

Обновлённый объект Sam AI аккаунта.

Ошибки

400parameter_invalid
API не принимает значение параметра. Название параметра указано в param.
400parameter_unknown
В теле есть поле, которое этот эндпоинт не принимает.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

PATCH/v1/account/sam

curl -X PATCH https://gemlead.ai/api/v1/account/sam \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Acme lets creators charge for their Discord. 5 percent a sale, no monthly fee, payouts every week. Sign up at https://acme.com/start."
  }'

Ответ200

{
  "object": "account_sam",
  "account_id": "a9PzK2vRtM",
  "enabled": true,
  "instructions": "Acme lets creators charge for their Discord. 5 percent a sale, no monthly fee, payouts every week. Sign up at https://acme.com/start.",
  "files": [
    {
      "id": "sf_4c1e9a07d2b35f68e190",
      "object": "sam_file",
      "name": "Pricing and payouts.pdf",
      "size": 182344,
      "mime_type": "application/pdf",
      "url": "https://upcdn.io/W142hYH/raw/uploads/GemleadSamFiles/api/7f3a9c21e5b04d18/Pricing-and-payouts.pdf"
    }
  ]
}

Объект Sam AI персоны

Sam AI на уровне персоны, для диалогов с её лидами.

Атрибуты

objectstring
Всегда persona_sam.
persona_idstring
ID персоны.
modestring
Режим тех диалогов персоны, у которых нет собственного режима. off оставляет их вам, draft соответствует режиму «Полуавто», где Sam AI предлагает ответ, а отправляете его вы, auto позволяет Sam AI отправлять самому. По умолчанию draft, пока вы его не измените.
offdraftauto
instructionsstring
Как писать этому типу покупателей и как им продавать, в приложении это Инструкции персоны. До 6 000 символов.
filesмассив objects
Файлы, которые Sam AI читает в диалогах персоны, в виде объектов файла Sam AI.

Объект Sam AI персоны

{
  "object": "persona_sam",
  "persona_id": "lvWBPnytpS",
  "mode": "draft",
  "instructions": "Tipsters want to get paid on time. Lead with the weekly payouts, keep it to two short messages, and offer the link once they ask how.",
  "files": []
}

Получение Sam AI персоны

GET/v1/personas/:persona_id/samПраво readMCPget_sam_settings

Возвращает режим Sam AI для диалогов персоны, её инструкции и её файлы.

Параметры пути

persona_idstringОбязательно
ID персоны.

Возвращает

Объект Sam AI персоны.

Ошибки

404resource_missing
В аккаунте ключа нет персоны с этим ID.

GET/v1/personas/:persona_id/sam

curl https://gemlead.ai/api/v1/personas/lvWBPnytpS/sam \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Ответ200

{
  "object": "persona_sam",
  "persona_id": "lvWBPnytpS",
  "mode": "draft",
  "instructions": "Tipsters want to get paid on time. Lead with the weekly payouts, keep it to two short messages, and offer the link once they ask how.",
  "files": []
}

Изменение Sam AI персоны

PATCH/v1/personas/:persona_id/samПраво writeMCPupdate_sam_settings

Меняет режим Sam AI в тех диалогах персоны, у которых нет собственного режима, или инструкции персоны. Меняются только переданные поля. В режиме auto ответы уходят с вашего аккаунта X сами.

Параметры пути

persona_idstringОбязательно
ID персоны.

Параметры тела

modestring
Режим Sam AI в диалогах персоны.
offdraftauto
instructionsstring
Как писать этому типу покупателей и как им продавать, до 6 000 символов. Пустая строка стирает текст.

Возвращает

Обновлённый объект Sam AI персоны.

Ошибки

404resource_missing
В аккаунте ключа нет персоны с этим ID.
400parameter_invalid
API не принимает значение параметра. Название параметра указано в param.
400parameter_unknown
В теле есть поле, которое этот эндпоинт не принимает.
403plan_required
auto для аккаунта на тарифе ниже Business.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

PATCH/v1/personas/:persona_id/sam

curl -X PATCH \
  https://gemlead.ai/api/v1/personas/lvWBPnytpS/sam \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "draft"
  }'

Ответ200

{
  "object": "persona_sam",
  "persona_id": "lvWBPnytpS",
  "mode": "draft",
  "instructions": "Tipsters want to get paid on time. Lead with the weekly payouts, keep it to two short messages, and offer the link once they ask how.",
  "files": []
}

Объект Sam AI диалога

Sam AI в одном диалоге, его режим, готовый ответ и то, что он знает об этом лиде.

Атрибуты

objectstring
Всегда conversation_sam.
conversation_idstring
ID диалога.
modestring
Собственный режим диалога или inherit, если он следует режиму персоны.
offdraftautoinherit
effective_modestring
Режим, который действует на самом деле. off, если Sam AI выключен на аккаунте X, диалог не входит ни в одну запущенную кампанию или тариф аккаунта ниже Business.
offdraftauto
personaobject или null
Персона, которую читает Sam AI, с её id, name и mode.
campaignobject или null
Кампания, в которой идёт диалог, с её id и name. Sam AI отвечает только в запущенной кампании.
statusstring
Что сейчас делает Sam AI. writing, когда он пишет ответ, suggested, когда ответ ждёт вас, scheduled, когда ответ уйдёт сам в suggestion.send_at, sending, sent, no_reply, когда он решил не отвечать, handoff, когда он передаёт диалог вам, no_credits, когда на балансе меньше 30 кредитов, нужных на один ответ, off или idle.
idlewritingsuggestedscheduledsendingsentno_replyhandoffno_creditsoff
reasonstring или null
Причина для no_reply и handoff в формулировке Sam AI.
suggestionobject или null
Готовый ответ Sam AI, пока status равен suggested, scheduled или sending.
instructionsstring
Что Sam AI должен знать именно об этом лиде. До 3 000 символов.
filesмассив objects
Файлы, которые Sam AI читает только в этом диалоге, в виде объектов файла Sam AI.
updated_atstring или null
Время последнего изменения состояния Sam AI, ISO 8601.

Объект Sam AI диалога

{
  "object": "conversation_sam",
  "conversation_id": "msgOtJ8dvT",
  "mode": "inherit",
  "effective_mode": "draft",
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters",
    "mode": "draft"
  },
  "campaign": {
    "id": "c7RkQ2wLxe",
    "name": "Tipsters warm intro"
  },
  "status": "suggested",
  "reason": null,
  "suggestion": {
    "messages": [
      "It takes two minutes. You set a price, members pay, and they get their Discord role right away.",
      "Want the link to set it up?"
    ],
    "edited": false,
    "stage": "answer_question",
    "why": "She asked how it works, so the reply explains it in one line and offers the link.",
    "replying_to_message_id": "1985321409876543210",
    "created_at": "2026-11-06T08:13:20.000Z",
    "send_at": null
  },
  "instructions": "She runs two Discords. Talk about the bigger one first.",
  "files": [],
  "updated_at": "2026-11-06T08:13:20.000Z"
}

Получение Sam AI диалога

GET/v1/conversations/:conversation_id/samПраво readMCPget_sam_settings

Возвращает режим Sam AI в диалоге и режим, который действует на самом деле, готовый ответ, а также собственные инструкции и файлы диалога.

Параметры пути

conversation_idstringОбязательно
ID диалога.

Возвращает

Объект Sam AI диалога.

Ошибки

404resource_missing
В аккаунте ключа нет диалога с этим ID.

GET/v1/conversations/:conversation_id/sam

curl https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/sam \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Ответ200

{
  "object": "conversation_sam",
  "conversation_id": "msgOtJ8dvT",
  "mode": "inherit",
  "effective_mode": "draft",
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters",
    "mode": "draft"
  },
  "campaign": {
    "id": "c7RkQ2wLxe",
    "name": "Tipsters warm intro"
  },
  "status": "suggested",
  "reason": null,
  "suggestion": {
    "messages": [
      "It takes two minutes. You set a price, members pay, and they get their Discord role right away.",
      "Want the link to set it up?"
    ],
    "edited": false,
    "stage": "answer_question",
    "why": "She asked how it works, so the reply explains it in one line and offers the link.",
    "replying_to_message_id": "1985321409876543210",
    "created_at": "2026-11-06T08:13:20.000Z",
    "send_at": null
  },
  "instructions": "She runs two Discords. Talk about the bigger one first.",
  "files": [],
  "updated_at": "2026-11-06T08:13:20.000Z"
}

Изменение Sam AI диалога

PATCH/v1/conversations/:conversation_id/samПраво writeMCPupdate_sam_settings

Задаёт режим Sam AI только в этом диалоге, возвращает диалог к режиму персоны через inherit или меняет то, что Sam AI знает об этом лиде. Меняются только переданные поля. В режиме auto ответы уходят с вашего аккаунта X сами.

Параметры пути

conversation_idstringОбязательно
ID диалога.

Параметры тела

modestring
Режим Sam AI в этом диалоге. inherit следует режиму персоны.
offdraftautoinherit
instructionsstring
Что Sam AI должен знать об этом лиде, до 3 000 символов. Пустая строка стирает текст.

Возвращает

Обновлённый объект Sam AI диалога.

Ошибки

404resource_missing
В аккаунте ключа нет диалога с этим ID.
400parameter_invalid
API не принимает значение параметра. Название параметра указано в param.
400parameter_unknown
В теле есть поле, которое этот эндпоинт не принимает.
403plan_required
auto для аккаунта на тарифе ниже Business.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

PATCH/v1/conversations/:conversation_id/sam

curl -X PATCH \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/sam \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "auto"
  }'

Ответ200

{
  "object": "conversation_sam",
  "conversation_id": "msgOtJ8dvT",
  "mode": "auto",
  "effective_mode": "auto",
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters",
    "mode": "draft"
  },
  "campaign": {
    "id": "c7RkQ2wLxe",
    "name": "Tipsters warm intro"
  },
  "status": "scheduled",
  "reason": null,
  "suggestion": {
    "messages": [
      "It takes two minutes. You set a price, members pay, and they get their Discord role right away.",
      "Want the link to set it up?"
    ],
    "edited": false,
    "stage": "answer_question",
    "why": "She asked how it works, so the reply explains it in one line and offers the link.",
    "replying_to_message_id": "1985321409876543210",
    "created_at": "2026-11-06T08:13:20.000Z",
    "send_at": "2026-11-06T08:14:05.000Z"
  },
  "instructions": "She runs two Discords. Talk about the bigger one first.",
  "files": [],
  "updated_at": "2026-11-06T08:13:20.000Z"
}

Объект файла Sam AI

Документ, который Sam AI читает перед каждым ответом, файл PDF, DOCX, TXT, MD или CSV. На каждом уровне не больше 30 файлов и 100 МБ.

Атрибуты

idstring
Уникальный идентификатор файла на его уровне.
objectstring
Всегда sam_file.
namestring
Название файла, как его показывает приложение.
sizeinteger
Его размер в байтах.
mime_typestring или null
Его тип, например application/pdf.
urlstring
Где Gemlead его хранит.

Объект файла Sam AI

{
  "id": "sf_4c1e9a07d2b35f68e190",
  "object": "sam_file",
  "name": "Pricing and payouts.pdf",
  "size": 182344,
  "mime_type": "application/pdf",
  "url": "https://upcdn.io/W142hYH/raw/uploads/GemleadSamFiles/api/7f3a9c21e5b04d18/Pricing-and-payouts.pdf"
}

Добавление файла в аккаунт

POST/v1/account/sam/filesПраво writeMCPedit_sam_files

Даёт Sam AI документ, который он читает в каждом диалоге аккаунта X. Передайте его публичный URL или байты в base64. Gemlead читает файл один раз, проверяет, что это PDF, DOCX, TXT, MD или CSV, и сохраняет собственную копию.

Параметры тела

urlstring
Файл по публичному HTTPS URL. Gemlead читает его один раз и сохраняет собственную копию. Укажите url или data.
datastring
Файл в кодировке base64 вместо url. Большой файл передавайте через url.
namestring
Название, которое показывает приложение, до 200 символов. Обязательно вместе с data, иначе берётся последняя часть URL. Gemlead добавляет расширение, если его нет.

Возвращает

Новый объект файла Sam AI.

Ошибки

400parameter_missing
Отсутствует обязательный параметр. Название параметра указано в param.
400parameter_invalid
Файл не в формате PDF, DOCX, TXT, MD или CSV, пустой или больше 25 МБ, либо его URL не удаётся прочитать. Название параметра указано в param.
400parameter_unknown
В теле есть поле, которое этот эндпоинт не принимает.
400limit_reached
На этом уровне уже 30 файлов или 100 МБ файлов. Сначала удалите один.
429rate_limit_exceeded
Больше 100 файлов в час на этом аккаунте X.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

POST/v1/account/sam/files

curl -X POST https://gemlead.ai/api/v1/account/sam/files \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://acme.com/docs/pricing-and-payouts.pdf",
    "name": "Pricing and payouts.pdf"
  }'

Ответ200

{
  "id": "sf_4c1e9a07d2b35f68e190",
  "object": "sam_file",
  "name": "Pricing and payouts.pdf",
  "size": 182344,
  "mime_type": "application/pdf",
  "url": "https://upcdn.io/W142hYH/raw/uploads/GemleadSamFiles/api/7f3a9c21e5b04d18/Pricing-and-payouts.pdf"
}

Удаление файла аккаунта

DELETE/v1/account/sam/files/:file_idПраво writeMCPedit_sam_files

Убирает файл с уровня. Sam AI перестаёт читать его со следующего ответа.

Параметры пути

file_idstringОбязательно
ID файла Sam AI.

Возвращает

Объект с id файла и deleted, равным true.

Ошибки

404resource_missing
В аккаунте ключа нет файла Sam AI с этим ID.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

DELETE/v1/account/sam/files/:file_id

curl -X DELETE \
  https://gemlead.ai/api/v1/account/sam/files/sf_4c1e9a07d2b35f68e190 \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Ответ200

{
  "id": "sf_4c1e9a07d2b35f68e190",
  "object": "sam_file",
  "deleted": true
}

Добавление файла в персону

POST/v1/personas/:persona_id/sam/filesПраво writeMCPedit_sam_files

Даёт Sam AI документ, который он читает в диалогах персоны. Передайте его публичный URL или байты в base64. Gemlead читает файл один раз, проверяет, что это PDF, DOCX, TXT, MD или CSV, и сохраняет собственную копию.

Параметры пути

persona_idstringОбязательно
ID персоны.

Параметры тела

urlstring
Файл по публичному HTTPS URL. Gemlead читает его один раз и сохраняет собственную копию. Укажите url или data.
datastring
Файл в кодировке base64 вместо url. Большой файл передавайте через url.
namestring
Название, которое показывает приложение, до 200 символов. Обязательно вместе с data, иначе берётся последняя часть URL. Gemlead добавляет расширение, если его нет.

Возвращает

Новый объект файла Sam AI.

Ошибки

404resource_missing
В аккаунте ключа нет персоны с этим ID.
400parameter_missing
Отсутствует обязательный параметр. Название параметра указано в param.
400parameter_invalid
Файл не в формате PDF, DOCX, TXT, MD или CSV, пустой или больше 25 МБ, либо его URL не удаётся прочитать. Название параметра указано в param.
400parameter_unknown
В теле есть поле, которое этот эндпоинт не принимает.
400limit_reached
На этом уровне уже 30 файлов или 100 МБ файлов. Сначала удалите один.
429rate_limit_exceeded
Больше 100 файлов в час на этом аккаунте X.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

POST/v1/personas/:persona_id/sam/files

curl -X POST \
  https://gemlead.ai/api/v1/personas/lvWBPnytpS/sam/files \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://acme.com/docs/pricing-and-payouts.pdf",
    "name": "Pricing and payouts.pdf"
  }'

Ответ200

{
  "id": "sf_4c1e9a07d2b35f68e190",
  "object": "sam_file",
  "name": "Pricing and payouts.pdf",
  "size": 182344,
  "mime_type": "application/pdf",
  "url": "https://upcdn.io/W142hYH/raw/uploads/GemleadSamFiles/api/7f3a9c21e5b04d18/Pricing-and-payouts.pdf"
}

Удаление файла персоны

DELETE/v1/personas/:persona_id/sam/files/:file_idПраво writeMCPedit_sam_files

Убирает файл с уровня. Sam AI перестаёт читать его со следующего ответа.

Параметры пути

persona_idstringОбязательно
ID персоны.
file_idstringОбязательно
ID файла Sam AI.

Возвращает

Объект с id файла и deleted, равным true.

Ошибки

404resource_missing
В аккаунте ключа нет файла Sam AI с этим ID.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

DELETE/v1/personas/:persona_id/sam/files/:file_id

curl -X DELETE \
  https://gemlead.ai/api/v1/personas/lvWBPnytpS/sam/files/sf_4c1e9a07d2b35f68e190 \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Ответ200

{
  "id": "sf_4c1e9a07d2b35f68e190",
  "object": "sam_file",
  "deleted": true
}

Добавление файла в диалог

POST/v1/conversations/:conversation_id/sam/filesПраво writeMCPedit_sam_files

Даёт Sam AI документ именно об этом лиде. Передайте его публичный URL или байты в base64. Gemlead читает файл один раз, проверяет, что это PDF, DOCX, TXT, MD или CSV, и сохраняет собственную копию.

Параметры пути

conversation_idstringОбязательно
ID диалога.

Параметры тела

urlstring
Файл по публичному HTTPS URL. Gemlead читает его один раз и сохраняет собственную копию. Укажите url или data.
datastring
Файл в кодировке base64 вместо url. Большой файл передавайте через url.
namestring
Название, которое показывает приложение, до 200 символов. Обязательно вместе с data, иначе берётся последняя часть URL. Gemlead добавляет расширение, если его нет.

Возвращает

Новый объект файла Sam AI.

Ошибки

404resource_missing
В аккаунте ключа нет диалога с этим ID.
400parameter_missing
Отсутствует обязательный параметр. Название параметра указано в param.
400parameter_invalid
Файл не в формате PDF, DOCX, TXT, MD или CSV, пустой или больше 25 МБ, либо его URL не удаётся прочитать. Название параметра указано в param.
400parameter_unknown
В теле есть поле, которое этот эндпоинт не принимает.
400limit_reached
На этом уровне уже 30 файлов или 100 МБ файлов. Сначала удалите один.
429rate_limit_exceeded
Больше 100 файлов в час на этом аккаунте X.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

POST/v1/conversations/:conversation_id/sam/files

curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/sam/files \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://acme.com/docs/pricing-and-payouts.pdf",
    "name": "Pricing and payouts.pdf"
  }'

Ответ200

{
  "id": "sf_4c1e9a07d2b35f68e190",
  "object": "sam_file",
  "name": "Pricing and payouts.pdf",
  "size": 182344,
  "mime_type": "application/pdf",
  "url": "https://upcdn.io/W142hYH/raw/uploads/GemleadSamFiles/api/7f3a9c21e5b04d18/Pricing-and-payouts.pdf"
}

Удаление файла диалога

DELETE/v1/conversations/:conversation_id/sam/files/:file_idПраво writeMCPedit_sam_files

Убирает файл с уровня. Sam AI перестаёт читать его со следующего ответа.

Параметры пути

conversation_idstringОбязательно
ID диалога.
file_idstringОбязательно
ID файла Sam AI.

Возвращает

Объект с id файла и deleted, равным true.

Ошибки

404resource_missing
В аккаунте ключа нет файла Sam AI с этим ID.
403forbidden
Ключ участника команды меняет раздел, который его роль может только просматривать. Переключатель аккаунта X и диалоги относятся к разделу чата, описание бизнеса и файлы к настройкам, а Sam AI персоны к персонам.

DELETE/v1/conversations/:conversation_id/sam/files/:file_id

curl -X DELETE \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/sam/files/sf_4c1e9a07d2b35f68e190 \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Ответ200

{
  "id": "sf_4c1e9a07d2b35f68e190",
  "object": "sam_file",
  "deleted": true
}