객체
Error
표준 오류 응답. detail 값은 문자열, code 필드가 있는 객체(예: choose_org, org_suspended, 초대 코드) 또는 유효성 검사 오류 목록(422)이에요. error 값은 구조화된 설명으로, 오류 카탈로그의 코드, 영어 메시지, 구조화된 세부 정보, 요청 ID가 담겨요.
필드
오류 메시지, 코드가 있는 객체 또는 유효성 검사 오류 목록.
errorErrorInfo
사용처
- GET
/v1/health서비스 상태 및 버전 조회 - GET
/v1/users조직의 사용자 목록 조회 - POST
/v1/users사용자 생성 - PATCH
/v1/users/{user_id}사용자 수정 - GET
/v1/api-keys조직의 API 키 목록 조회 - POST
/v1/api-keysAPI 키 생성 - DELETE
/v1/api-keys/{key_id}API 키 폐기 - PATCH
/v1/api-keys/{key_id}API 키 수정 - POST
/v1/api-keys/{key_id}/rollAPI 키 재발급 - POST
/v1/api-keys/{key_id}/revoke-previousAPI 키의 이전 값 폐기 - GET
/v1/audit감사 로그 항목 목록 조회 - GET
/v1/audit/actions감사 로그 동작 목록과 건수 조회 - GET
/v1/audit/export.csv감사 로그 CSV 내보내기 - GET
/v1/org조직 조회 - GET
/v1/categories문서 카테고리 목록 조회 - POST
/v1/categories카테고리 생성 - DELETE
/v1/categories/{key}사용자 지정 카테고리 삭제 - PATCH
/v1/categories/{key}카테고리 수정 - GET
/v1/collections사용자가 접근할 수 있는 컬렉션 목록 조회 - POST
/v1/collections컬렉션 생성 - DELETE
/v1/collections/{name}컬렉션 삭제 - PATCH
/v1/collections/{name}컬렉션 수정 - POST
/v1/collections/{name}/reindex컬렉션 재인덱싱 - GET
/v1/collections/{name}/stats컬렉션 개요 조회: 통계, 카테고리, 최근 카드, 권한 - GET
/v1/cards카드 목록 조회 - POST
/v1/cards파일을 카드로 업로드 - GET
/v1/jobs인덱싱 작업 목록 조회 - GET
/v1/jobs/summary대기열 요약 조회 - GET
/v1/jobs/stream작업 변경 스트리밍(SSE) - GET
/v1/jobs/{job_id}작업 조회 - DELETE
/v1/jobs/{job_id}대기 중인 작업 취소 - GET
/v1/cards/count카드 수 조회 - GET
/v1/cards/export.xlsx카드 목록 XLSX 내보내기 - POST
/v1/cards/bulk카드 일괄 작업 실행 - GET
/v1/cards/{card_id}카드 조회(버전, 댓글, 표, 이벤트 포함) - DELETE
/v1/cards/{card_id}카드 삭제 - PATCH
/v1/cards/{card_id}카드 수정 - GET
/v1/cards-by-external-id/{external_id}외부 ID로 카드 조회 - PUT
/v1/cards-by-external-id/{external_id}외부 ID로 카드 생성 또는 교체 - GET
/v1/cards/{card_id}/content섹션별 카드 텍스트 조회 - PUT
/v1/cards/{card_id}/content카드 내용 교체 - GET
/v1/cards/{card_id}/tables/{table_id}/rows팩트 테이블 행 목록 조회 - GET
/v1/cards/{card_id}/versions/{a}/diff/{b}카드의 두 버전 비교 - GET
/v1/cards/{card_id}/usage답변에 카드가 쓰인 질문 목록 조회 - POST
/v1/cards/{card_id}/usage카드 사용 이벤트 기록 - POST
/v1/cards/{card_id}/reindex카드 재인덱싱 - DELETE
/v1/cards/{card_id}/comments/{comment_id}댓글 삭제 - GET
/v1/cards/{card_id}/file카드 원본 파일 다운로드 - GET
/v1/cards/{card_id}/export카드를 문서로 내보내기 - POST
/v1/cards/{card_id}/verify카드가 최신 상태임을 확인 - POST
/v1/cards/{card_id}/comments댓글 추가 - GET
/v1/conversations대화 목록 조회 - GET
/v1/conversations/{conv_id}대화 조회(턴 포함) - POST
/v1/search컬렉션 검색 - POST
/v1/ask어시스턴트 답변 조회(스트리밍 없음) - POST
/v1/chat어시스턴트 답변 스트리밍(SSE) - POST
/v1/questions/{question_id}/feedback답변 평가 - GET
/v1/questions/export.csv질문 기록 CSV 내보내기 - GET
/v1/questions/{question_id}저장된 질문과 답변 조회 - GET
/v1/questions/{question_id}/followups후속 질문 제안 조회 - GET
/v1/questions질문 기록 목록 조회 - GET
/v1/questions/{question_id}/export답변을 문서로 내보내기 - GET
/v1/questions/{question_id}/datasets/{dataset_id}/export답변의 데이터 세트 내보내기 - GET
/v1/questions/{question_id}/answer-tables/{index}/export답변 본문의 표 내보내기 - POST
/v1/questions/{question_id}/refresh답변의 데이터 세트 새로 고침(실시간 답변) - POST
/v1/questions/{question_id}/save-card답변을 카드로 저장 - POST
/v1/cards/text텍스트 카드 생성(Markdown) - GET
/v1/files내보내기 파일 목록 조회 - GET
/v1/files/authors파일 작성자 목록 조회(관리자 필터용) - GET
/v1/files/{file_id}파일 정보 조회 - DELETE
/v1/files/{file_id}파일 삭제 - GET
/v1/files/{file_id}/download파일 다운로드 - GET
/v1/files/{file_id}/preview파일 미리 보기 - POST
/v1/files/{file_id}/extend파일 보존 기간 연장 - POST
/v1/files/{file_id}/regenerate저장된 파라미터로 파일 다시 생성 - GET
/v1/tasks사용자나 팀의 할 일 목록 조회 - POST
/v1/sources소스 생성 - GET
/v1/sources/{source_id}소스 조회 - DELETE
/v1/sources/{source_id}소스 삭제 - PATCH
/v1/sources/{source_id}소스 수정 - PATCH
/v1/sources/{source_id}/settings소스 설정 수정 - GET
/v1/cards/{card_id}/similar유사 카드 목록 조회 - GET
/v1/insights/gaps지식 빈틈 목록 조회(답변하지 못한 질문 묶음) - GET
/v1/permissions권한 레지스트리 목록 조회 - POST
/v1/uploads멀티파트 업로드 시작 - GET
/v1/uploads/{upload_id}업로드 조회 - DELETE
/v1/uploads/{upload_id}업로드 취소 - PUT
/v1/uploads/{upload_id}/parts/{n}업로드 파트 전송 - POST
/v1/uploads/{upload_id}/complete업로드 완료 - GET
/v1/meAPI 호출자 조회 - GET
/v1/me/permissions조직에 대한 현재 사용자의 권한 조회 - GET
/v1/roles역할 목록 조회(기본 제공 역할과 사용자 지정 역할) - POST
/v1/roles사용자 지정 역할 생성 - DELETE
/v1/roles/{role_id}사용자 지정 역할 삭제 - PATCH
/v1/roles/{role_id}사용자 지정 역할 수정 - GET
/v1/groups조직의 그룹 목록 조회 - POST
/v1/groups그룹 생성 - GET
/v1/groups/{group_id}그룹과 멤버 조회 - DELETE
/v1/groups/{group_id}그룹 삭제 - PATCH
/v1/groups/{group_id}그룹 이름 변경 - PUT
/v1/groups/{group_id}/members/{user_id}그룹에 멤버 추가 - DELETE
/v1/groups/{group_id}/members/{user_id}그룹에서 멤버 제거 - GET
/v1/org/permissions조직에 대한 권한 조회(관리자 확인) - PUT
/v1/org/permissions조직에 대한 역할 부여 - DELETE
/v1/org/permissions조직에 대한 역할 회수 - GET
/v1/collections/{name}/permissions컬렉션에 대한 권한 조회(직접 부여와 상속) - PUT
/v1/collections/{name}/permissions컬렉션에 대한 역할 부여 - DELETE
/v1/collections/{name}/permissions컬렉션에 대한 역할 회수 - GET
/v1/cards/{card_id}/permissions카드에 대한 권한 조회(직접 부여와 상속) - PUT
/v1/cards/{card_id}/permissions카드에 대한 역할 부여 - DELETE
/v1/cards/{card_id}/permissions카드에 대한 역할 회수 - GET
/v1/sources/{source_id}/permissions소스에 대한 권한 조회(직접 부여와 상속) - PUT
/v1/sources/{source_id}/permissions소스에 대한 역할 부여 - DELETE
/v1/sources/{source_id}/permissions소스에 대한 역할 회수 - POST
/v1/users/{user_id}/offboard사용자 오프보딩 - GET
/v1/collections/{name}/folders컬렉션의 폴더 트리 조회 - POST
/v1/collections/{name}/folders폴더 생성 - GET
/v1/folders모든 컬렉션의 폴더 트리 조회 - GET
/v1/folders/{folder_id}폴더 조회 - DELETE
/v1/folders/{folder_id}폴더 삭제(내용은 한 단계 위로 이동) - PATCH
/v1/folders/{folder_id}폴더 이름 변경, 이동, 순서 변경 - GET
/v1/folders/{folder_id}/cards폴더의 카드 목록 조회 - GET
/v1/folders/{folder_id}/permissions폴더에 대한 권한 조회(직접 부여와 상속) - PUT
/v1/folders/{folder_id}/permissions폴더에 대한 역할 부여 - DELETE
/v1/folders/{folder_id}/permissions폴더에 대한 역할 회수 - GET
/v1/catalog/services카탈로그의 서비스 목록 조회 - GET
/v1/catalog/services/{service_id}카탈로그 서비스 조회 - GET
/v1/catalog/services/{service_id}/icon서비스 아이콘 조회 - GET
/v1/catalog/categories카탈로그 카테고리 목록 조회 - GET
/v1/catalog/spend-taxonomy지출·수익 분류 체계 조회 - POST
/v1/catalog/resolve이름과 카탈로그 서비스 매칭 - GET
/v1/drafts초안 목록 조회 - POST
/v1/drafts초안 생성 - GET
/v1/drafts/{draft_id}초안 조회 - PATCH
/v1/drafts/{draft_id}초안 수정 - POST
/v1/drafts/{draft_id}/request-publish게시 요청 - POST
/v1/drafts/{draft_id}/approve게시 승인 - GET
/v1/tags조직의 카드 태그 목록 조회 - POST
/v1/cards/archive문서 압축 파일 업로드 - GET
/v1/archives/{job_id}압축 해제 작업 조회 - GET
/v1/cards/{card_id}/verification카드의 검증 정보 조회 - POST
/v1/cards/{card_id}/verification/verify카드 검증 - POST
/v1/cards/{card_id}/verification/unverify신뢰 해제 또는 검증자에게 리마인더 전송 - PUT
/v1/cards/{card_id}/verification/verifiers카드 검증자 지정 - PUT
/v1/cards/{card_id}/verification/interval검증 유형과 기한 변경 - GET
/v1/verification/queue검증 대기열 조회 - GET
/v1/collections/{name}/trust컬렉션의 신뢰도 점수 조회 - GET
/v1/org/trust조직의 신뢰도 점수 조회 - GET
/v1/announcements공지 목록 조회 - POST
/v1/announcements필독 공지 전송 - GET
/v1/announcements/{announcement_id}공지 조회 - GET
/v1/announcements/{announcement_id}/stats공지 보고서 조회 - POST
/v1/announcements/{announcement_id}/remind읽지 않은 수신자에게 리마인더 전송 - GET
/v1/cards/{card_id}/threads카드의 댓글 스레드 목록 조회 - POST
/v1/cards/{card_id}/threads스레드에 댓글이나 답글 추가 - DELETE
/v1/cards/{card_id}/threads/{comment_id}댓글과 답글 삭제 - PATCH
/v1/cards/{card_id}/threads/{comment_id}스레드 본문 편집, 해결됨으로 표시, 다시 열기 - GET
/v1/openapi-public.json공개 OpenAPI 명세 조회 - GET
/v1/webhooks조직의 웹훅 목록 조회 - POST
/v1/webhooks웹훅 생성 - GET
/v1/webhooks/catalog이벤트 유형 목록 조회 - GET
/v1/webhooks/{webhook_id}웹훅 조회 - DELETE
/v1/webhooks/{webhook_id}웹훅 삭제 - PATCH
/v1/webhooks/{webhook_id}웹훅 수정 - POST
/v1/webhooks/{webhook_id}/test테스트 이벤트 전송 - POST
/v1/webhooks/{webhook_id}/rotate-secret서명 시크릿 교체 - POST
/v1/webhooks/{webhook_id}/revoke-previous-secret이전 시크릿 폐기 - POST
/v1/webhooks/{webhook_id}/resume웹훅 재개 - POST
/v1/webhooks/{webhook_id}/redeliver기간을 지정한 일괄 재전송 - GET
/v1/webhooks/{webhook_id}/attempts전송 시도 목록 조회 - GET
/v1/webhooks/{webhook_id}/deliveries웹훅 전송 목록 조회 - GET
/v1/webhooks/{webhook_id}/deliveries/{delivery_id}전송 조회(본문과 시도 포함) - POST
/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliver이벤트 재전송 - GET
/v1/webhook-events이벤트 목록 조회 - GET
/v1/webhook-events/{event_id}이벤트 조회 - GET
/v1/api-usageAPI 사용량 조회 - GET
/v1/api-logsAPI 요청 목록 조회 - GET
/v1/api-logs/{request_id}API 요청 조회 - GET
/v1/appsOAuth 앱 목록 조회 - POST
/v1/appsOAuth 앱 생성 - GET
/v1/apps/{app_id}OAuth 앱 조회 - DELETE
/v1/apps/{app_id}OAuth 앱 삭제 - PATCH
/v1/apps/{app_id}OAuth 앱 수정 - POST
/v1/apps/{app_id}/rotate-secret클라이언트 시크릿 교체 - GET
/v1/app-authorizations앱 인가 목록 조회 - DELETE
/v1/app-authorizations/{authorization_id}직원 인가 취소 - GET
/v1/analytics/health지식 상태 대시보드 조회 - GET
/v1/analytics/usage사용량 대시보드 조회 - GET
/v1/analytics/contribution기여 대시보드 조회 - GET
/v1/analytics/cards/{card_id}카드 지표 조회 - GET
/v1/audit/verify조직 감사 로그의 무결성 확인 - POST
/v1/users/importCSV로 사용자 가져오기 - GET
/v1/quality/gaps/followups처리 중인 지식 빈틈 목록 조회 - POST
/v1/quality/gaps/followups지식 빈틈 처리 시작 - PATCH
/v1/quality/gaps/followups/{followup_id}처리 중인 지식 빈틈 수정 - GET
/v1/access-requests본인 또는 받은 접근 요청 목록 조회 - GET
/v1/access-requests/{request_id}결정권자용 접근 요청 조회 - POST
/v1/access-requests/{request_id}/grant요청에 따른 접근 권한 부여 - POST
/v1/access-requests/{request_id}/deny접근 거부 - POST
/v1/finance/report재무 요약 보고서 조회 - POST
/v1/finance/report/export재무 요약 보고서 내보내기 - POST
/v1/finance/invoices청구서 목록 조회 - POST
/v1/finance/invoices/export청구서 목록 내보내기 - POST
/v1/finance/payments결제 목록 조회 - POST
/v1/finance/payments/export결제 목록 내보내기 - GET
/v1/sources/{source_id}/push-keys사용자 지정 소스의 API 키 목록 조회 - POST
/v1/sources/{source_id}/push-keys사용자 지정 소스의 API 키 생성 - DELETE
/v1/sources/{source_id}/push-keys/{key_id}사용자 지정 소스의 API 키 폐기 - GET
/v1/sources/{source_id}/push-syncs사용자 지정 소스의 동기화 목록 조회 - GET
/v1/push/sources/{source_id}키 확인과 사용자 지정 소스 상태 조회 - POST
/v1/push/sources/{source_id}/syncs동기화 열기 - GET
/v1/push/sources/{source_id}/syncs/{sync_number}동기화 조회 - GET
/v1/push/sources/{source_id}/syncs/{sync_number}/documents동기화의 문서별 결과 목록 조회 - POST
/v1/push/sources/{source_id}/syncs/{sync_number}/close동기화 닫기 - POST
/v1/push/sources/{source_id}/syncs/{sync_number}/touch문서를 다시 보내지 않고 확인 - POST
/v1/push/sources/{source_id}/documents문서 보내기(생성 또는 교체) - POST
/v1/push/sources/{source_id}/documents/batch문서 배치 보내기 - GET
/v1/push/sources/{source_id}/documents/{external_id}문서 결과 조회 - DELETE
/v1/push/sources/{source_id}/documents/{external_id}문서 삭제