API 레퍼런스

커스텀 통합을 구축하고, 워크플로우를 자동화하며, 프로그래밍 방식으로 어시스턴트를 관리하세요.

참고: CollowAI 애플리케이션 API는 Railway에서 실행됩니다. 위젯 채팅, Webhook, 프로그래밍 방식 접근을 위한 REST 엔드포인트를 제공합니다. 자세한 내용은 아래 섹션을 참조하세요.

HTTP 엔드포인트

위젯 임베딩 및 Webhook 처리를 위한 HTTP 엔드포인트:

POST/api/chat

어시스턴트에게 메시지를 보내고 AI가 생성한 응답을 받습니다. 임베딩 가능한 위젯에서 사용됩니다. 어시스턴트 ID, 사용자 메시지, 선택적 대화 컨텍스트를 허용합니다.

POST/api/webhooks/polar

Polar.sh 결제 이벤트(구독, 송장 등)를 위한 Webhook 수신기. Polar.sh 조직 설정에서 구성하세요.

백엔드 API

CollowAI 애플리케이션 API는 Railway에서 실행됩니다. 모든 엔드포인트는 REST API를 통해 접근할 수 있습니다. 일반적인 리소스 그룹은 다음과 같습니다:

어시스턴트

어시스턴트를 생성, 업데이트, 삭제, 조회하고 설정, 모델, 상태를 관리합니다.

대화

대화를 조회하고, 메시지를 보내며, 모든 어시스턴트의 메시지 기록을 검색합니다.

지식 소스

문서를 업로드하고, 데이터베이스 연결을 관리하며, 각 어시스턴트의 지식 베이스를 구성합니다.

통합

제3자 통합을 연결 및 관리하고, 동기화 상태를 확인하며, 수동 동기화를 트리거합니다.

위젯 설정

브랜딩, 위치, 임베딩 채팅을 위한 커스텀 CSS를 포함한 위젯 설정을 구성 및 조회합니다.

세컨드 브레인

문서에서 추출된 엔티티, 사실, 주제, 관계, 충돌 등 구조화된 지식을 쿼리합니다.

결제 및 구독

구독 상태를 조회하고, 송장을 조회하며, 결제 정보를 관리합니다.

클라이언트 SDK 사용법

커스텀 통합의 경우 REST API를 직접 사용하세요:

# List assistants
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants

# Create an assistant
curl -X POST \
  -H "Authorization: Bearer assai_*" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Assistant"}' \
  https://api.collowai.com/api/v1/assistants

# Get Second Brain stats
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/stats

# List brain entities
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/entities

# List brain facts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/facts

# List brain topics
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/topics

# List brain relationships
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/relationships

# List brain conflicts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/conflicts

# Get brain extractions history
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/extractions

인증

API 요청은 대시보드(Settings > API Keys)에서 생성한 API 키로 인증됩니다. Authorization 헤더에 키를 포함하세요:

Authorization: Bearer YOUR_API_KEY