Перейти к содержимому
Agentum Cloud для разработчиков

Overview

Agentum Cloud API 1.0.590

Заголовок раздела «Agentum Cloud API 1.0.590»

REST-контракт умного облака: загрузка документов, поиск по смыслу, ответы с цитатами, преобразования файлов и агент с инструментами.

  • Авторизация — Authorization: Bearer ak_…. Токен выпускается в приложении и видит только файлы своего аккаунта.
  • Загрузка асинхронна: объект отвечает status="pending", пока не обработан. Искать по содержимому сразу после загрузки бесполезно — дождитесь готовности.
  • Тяжёлые операции возвращают task_id; готовность спрашивается у соответствующего */status-маршрута.

Готовый клиент на Python — pip install agentum-cloud-sdk.

Information

  • OpenAPI version: 3.1.0

Operations

Заголовок раздела «Operations»
GET
/health
GET
/health/deep
POST
/v1/agent/chat
POST
/v1/agent/continue
GET
/v1/agent/memory
DELETE
/v1/agent/memory
DELETE
/v1/agent/memory/{memory_id}
GET
/v1/agent/proactive
GET
/v1/agent/status
GET
/v1/agent/task/{task_id}
GET
/v1/agents
POST
/v1/agents/custom
DELETE
/v1/agents/custom/{slug}
PATCH
/v1/agents/custom/{slug}
POST
/v1/agents/{slug}/activate
POST
/v1/ask
POST
/v1/assistant/command
GET
/v1/bots
POST
/v1/bots
GET
/v1/bots/{bot_id}
DELETE
/v1/bots/{bot_id}
PATCH
/v1/bots/{bot_id}
GET
/v1/bots/{bot_id}/chats
GET
/v1/bots/{bot_id}/chats/{chat_id}
PATCH
/v1/bots/{bot_id}/chats/{chat_id}
POST
/v1/bots/{bot_id}/chats/{chat_id}/folder
PATCH
/v1/bots/{bot_id}/chats/{chat_id}/members/{tg_user_id}
POST
/v1/bots/{bot_id}/chats/{chat_id}/sync
GET
/v1/bots/{bot_id}/subscribers
GET
/v1/calendar/agenda
GET
/v1/calendar/events
POST
/v1/calendar/events
GET
/v1/calendar/events/{event_id}
DELETE
/v1/calendar/events/{event_id}
PATCH
/v1/calendar/events/{event_id}
GET
/v1/calendar/feeds
POST
/v1/calendar/feeds
POST
/v1/calendar/feeds/import
DELETE
/v1/calendar/feeds/{feed_id}
POST
/v1/chat
POST
/v1/chat/attachment
GET
/v1/chats
GET
/v1/chats/{chat_id}
DELETE
/v1/chats/{chat_id}
PATCH
/v1/chats/{chat_id}
DELETE
/v1/chats/{chat_id}/messages/{message_id}
GET
/v1/collections
POST
/v1/collections
DELETE
/v1/collections/{collection_id}
PATCH
/v1/collections/{collection_id}
GET
/v1/collections/{collection_id}/note
POST
/v1/collections/{collection_id}/objects/{object_id}
DELETE
/v1/collections/{collection_id}/objects/{object_id}
POST
/v1/collections/{collection_id}/objects/{object_id}/primary
GET
/v1/corrections
POST
/v1/corrections
POST
/v1/corrections/{correction_id}/revert
GET
/v1/facts
POST
/v1/facts
DELETE
/v1/facts
DELETE
/v1/facts/{fact_id}
GET
/v1/objects/{object_id}/corrections
POST
/v1/objects/{object_id}/corrections
POST
/v1/documents/generate
GET
/v1/documents/status/{task_id}
POST
/v1/events
GET
/v1/hidden-pin
POST
/v1/hidden-pin
POST
/v1/hidden-pin/disable
POST
/v1/hidden-pin/verify
GET
/v1/integrations
PUT
/v1/integrations/llm
PUT
/v1/integrations/s3
GET
/v1/integrations/s3/migration
POST
/v1/integrations/s3/migration
DELETE
/v1/integrations/{kind}
PATCH
/v1/integrations/{kind}
POST
/v1/integrations/{kind}/test
DELETE
/v1/integrations/google
POST
/v1/integrations/google/connect
GET
/v1/integrations/google/status
POST
/v1/intent
GET
/v1/memory/suggestions
GET
/v1/models
GET
/v1/notifications
POST
/v1/notifications/read
DELETE
/v1/notifications/{notification_id}
GET
/v1/objects
POST
/v1/objects
POST
/v1/objects/archive
POST
/v1/objects/assemble
GET
/v1/objects/content-status/{task_id}
POST
/v1/objects/convert-by-query
GET
/v1/objects/convert-status/{task_id}
GET
/v1/objects/image-status/{task_id}
POST
/v1/objects/link
GET
/v1/objects/pdf-status/{task_id}
GET
/v1/objects/protocol-status/{task_id}
POST
/v1/objects/reorganize
GET
/v1/objects/reorganize/{task_id}
POST
/v1/objects/trash/empty
POST
/v1/objects/zip
GET
/v1/objects/{object_id}
DELETE
/v1/objects/{object_id}
PATCH
/v1/objects/{object_id}
POST
/v1/objects/{object_id}/accept-folder
POST
/v1/objects/{object_id}/apply-ai-name
POST
/v1/objects/{object_id}/compare
GET
/v1/objects/{object_id}/content
PUT
/v1/objects/{object_id}/content
POST
/v1/objects/{object_id}/convert
GET
/v1/objects/{object_id}/convert-targets
GET
/v1/objects/{object_id}/diarization
POST
/v1/objects/{object_id}/diarize
GET
/v1/objects/{object_id}/diarize-status/{task_id}
GET
/v1/objects/{object_id}/draft
PUT
/v1/objects/{object_id}/draft
DELETE
/v1/objects/{object_id}/draft
PATCH
/v1/objects/{object_id}/enrichment
POST
/v1/objects/{object_id}/image/{op}
POST
/v1/objects/{object_id}/lock-name
GET
/v1/objects/{object_id}/page-image
GET
/v1/objects/{object_id}/pdf-info
POST
/v1/objects/{object_id}/pdf/{op}
DELETE
/v1/objects/{object_id}/permanent
POST
/v1/objects/{object_id}/protocol
GET
/v1/objects/{object_id}/protocol/questions
GET
/v1/objects/{object_id}/questions
GET
/v1/objects/{object_id}/raw
POST
/v1/objects/{object_id}/reprocess
POST
/v1/objects/{object_id}/restore
POST
/v1/objects/{object_id}/restore-name
GET
/v1/objects/{object_id}/revisions
POST
/v1/objects/{object_id}/revisions/{version}/restore
POST
/v1/objects/{object_id}/save-to-cloud
PATCH
/v1/objects/{object_id}/speakers
POST
/v1/objects/{object_id}/summarize
GET
/v1/objects/{object_id}/text-content
GET
/v1/objects/{object_id}/thumbnail
GET
/v1/objects/{object_id}/transcript
GET
/v1/objects/{object_id}/summary
POST
/v1/objects/{object_id}/translate
GET
/v1/office/config/{object_id}
GET
/v1/recent-queries
GET
/v1/referral
POST
/v1/referral/apply
POST
/v1/rewrite
GET
/v1/search
GET
/v1/settings
PUT
/v1/settings
DELETE
/v1/settings/chat-memory
GET
/v1/share/{token}
GET
/v1/share/{token}/objects
GET
/v1/share/{token}/objects/{object_id}/content
GET
/v1/share/{token}/objects/{object_id}/page-image
GET
/v1/share/{token}/objects/{object_id}/pdf-info
GET
/v1/share/{token}/objects/{object_id}/raw
GET
/v1/share/{token}/objects/{object_id}/thumbnail
POST
/v1/share/{token}/upload
GET
/v1/shares
POST
/v1/shares
DELETE
/v1/shares/{link_id}
GET
/v1/tasks
PATCH
/v1/tasks/{task_id}
POST
/v1/telegram/bind
GET
/v1/themes
POST
/v1/themes
DELETE
/v1/themes/{theme_id}
PATCH
/v1/themes/{theme_id}
POST
/v1/transcribe
GET
/v1/usage
GET
/v1/usage/breakdown
GET
/v1/usage/history
GET
/v1/usage/quota
GET
/v1/usage/tokens
GET
/v1/voice-profiles
DELETE
/v1/voice-profiles/{profile_id}

Authentication

Заголовок раздела «Authentication»

bearerAuth

Заголовок раздела «bearerAuth»

Токен ak_… из приложения app.agentums.ru: Настройки → API-токены → Создать. Показывается один раз; скомпрометированный — отозвать там же.

Security scheme type: http