검색은 사용할 때만 로드됩니다. 아래에서 모든 분류를 살펴보세요.
SosoAPI · 개발자 문서
API 참조
앱에서 호출 가능한 작업 107개와 에이전트 로그인 엔드포인트 4개. 작업을 열어 요청 필드, 응답, 권한, 호출 예제를 확인하세요.
계정 및 Workspace
- Organization 컨텍스트 조회
POST /identity-api/agent/organization-context실시간 Organization, Workspace, Channel 권한을 읽습니다. - API 키 생성
POST /identity-api/api-keys/create선택한 기능과 선택적 Workspace 제한으로 API 키를 생성하며 비밀 값은 한 번만 반환됩니다. 에이전트는 자신의 권한 안에서 최대 30일까지만 부여할 수 있으며, 하나의 승인에는 활성 키가 최대 25개까지 허용됩니다(API_KEY_GRANT_KEY_LIMIT). - API 키 만료 연장
POST /identity-api/api-keys/extendAPI 키 만료를 현재부터 최대 365일(에이전트 생성 키는 30일)까지 연장합니다. 이후 시간은 API_KEY_LIFETIME_EXCEEDS_CAP으로 거부됩니다. 응답에 적용된 만료가 담깁니다. - API 키 목록 조회
POST /identity-api/api-keys/list비밀 값 없이 API 키 메타데이터를 조회합니다. 기능과 Workspace 제한은 include_authority를 설정하세요. - API 키 교체 갱신
POST /identity-api/api-keys/renew같은 기능과 Workspace 제한을 가진 비파괴적 후속 API 키를 생성합니다. - API 키 취소
POST /identity-api/api-keys/revokeAPI 키를 취소합니다. 에이전트는 자신이 생성한 키만 취소할 수 있습니다. - 청구 상태 조회
POST /identity-api/billing/status청구 요금제, 이용 권리, 할당량 정보를 읽습니다. - 상용 이용 권한 조회
POST /identity-api/commercial-access/statusWorkspace 상용 이용 권한 정보를 확인합니다. - 의견 제출
POST /identity-api/feedback/submit출처 정보와 함께 제품 의견을 제출합니다. - Workspace 구성원 목록 조회
POST /identity-api/member/list구성원과 대기 초대를 읽습니다. - Organization 채널 목록 조회
POST /identity-api/organization/channels/list채널과 Workspace 연결 상태를 조회합니다. - 채널 이동 미리 확인
POST /identity-api/organization/channels/move/preview채널 이동 전 차단 요인을 확인합니다. - Organization 연결 목록 조회
POST /identity-api/organization/connections/listOrganization 제공업체 연결을 읽습니다. - Organization 연결 검토
POST /identity-api/organization/connections/review검토용으로 발견된 정확한 제공업체 리소스를 읽습니다. - Organization 목록 조회
POST /identity-api/organization/list인증된 사용자가 볼 수 있는 Organization을 조회합니다. - 받은 알림 목록 조회
POST /identity-api/user/inbox/list인증된 사용자의 받은 알림을 읽습니다. - 알림 설정 조회
POST /identity-api/user/notifications/get알림 전송 설정을 읽습니다. - 알림 설정 수정
POST /identity-api/user/notifications/update알림 전송 설정을 수정합니다. - 사용자 프로필 조회
POST /identity-api/user/profile/get인증된 사용자 프로필을 읽습니다. - 아바타 업로드 서명
POST /identity-api/user/profile/sign-avatar-url서명된 아바타 업로드 URL을 가져옵니다. - 사용자 프로필 수정
POST /identity-api/user/profile/update인증된 사용자 프로필을 수정합니다. - 소셜 계정 차단 해제
POST /identity-api/user/social-accounts/clear-block게시물 재시도 없이 계정 대기 시간을 해제합니다. 대기 시간이 아직 유효하거나 계정이 세 번째 대기 시간에 도달하면 에이전트 자격 증명은 거부됩니다. 어떤 호출자든 계정을 10분에 한 번까지만 해제할 수 있습니다. - 소셜 계정 연결 해제
POST /identity-api/user/social-accounts/disconnectWorkspace의 소셜 계정 연결을 해제합니다. - 연결된 계정 목록 조회
POST /identity-api/user/social-accounts/listWorkspace에 연결된 소셜 계정을 조회합니다. - 소셜 계정 자동 동기화 설정
POST /identity-api/user/social-accounts/set-auto-sync계정 자동 동기화를 켜거나 끕니다. - Workspace 생성
POST /identity-api/workspace/create소유하거나 관리하는 Organization에 Workspace를 생성합니다. 여러 Organization에 속하면 organization_id를 전달하세요. - Workspace 컨텍스트 조회
POST /identity-api/workspace/listWorkspace 목록과 활성 Workspace를 조회합니다. - Workspace 수정
POST /identity-api/workspace/updateWorkspace 이름 또는 slug를 수정합니다.
미디어 및 에셋
- 에셋 생성
POST /assets-api/create에셋 메타데이터를 등록합니다. - 에셋 삭제
POST /assets-api/delete에셋 하나를 삭제합니다. - 에셋 내보내기 생성
POST /assets-api/exports/create에셋 내보내기 증거 작업을 생성합니다. - 에셋 내보내기 상태 조회
POST /assets-api/exports/status영속적인 에셋 내보내기 상태를 읽습니다. - 에셋 내보내기 검증
POST /assets-api/exports/verify영구 삭제 전에 에셋 내보내기를 검증하세요. - 에셋 조회
POST /assets-api/getID로 에셋 하나를 읽습니다. - 에셋 가져오기 상태 조회
POST /assets-api/imports/status영속적인 미디어 가져오기 상태를 읽습니다. - 에셋 URL 가져오기
POST /assets-api/imports/url명시적 외부 미디어 수집을 대기열에 넣습니다. - 에셋 검색
POST /assets-api/list이전 버전과 호환되는 필터로 에셋을 검색합니다. - 에셋 목록 조회
POST /assets-api/list-workspaceWorkspace 에셋을 조회합니다. - 고아 에셋 삭제
POST /assets-api/orphans/delete선택한 미등록 R2 객체를 삭제합니다. - 고아 에셋 목록 조회
POST /assets-api/orphans/list등록되지 않은 R2 객체를 조회합니다. - 에셋 영구 삭제 요청
POST /assets-api/purges/request소유자 펜스가 적용된 에셋 영구 삭제를 요청합니다. - 에셋 영구 삭제 재시도
POST /assets-api/purges/retry적격한 펜스 적용 영구 삭제를 재시도합니다. - 에셋 스토리지 목록 조회
POST /assets-api/storage/inventory범위가 제한된 등록 에셋/객체 스토리지 목록을 읽습니다. - 에셋 수정
POST /assets-api/update에셋 메타데이터를 수정합니다. - 에셋 업로드 완료
POST /assets-api/upload/complete서명된 객체 ID와 멱등성 키를 사용하여 업로드된 Workspace 미디어 객체의 등록을 완료합니다. - 에셋 업로드 서명
POST /assets-api/upload/sign원하는 Workspace 미디어 객체용 서명 업로드 URL을 요청합니다. 등록을 완료하기 전에 바이트를 업로드하세요.
프로젝트 및 콘텐츠
- 프로젝트 기본 계정 조회
POST /studio-api/projects/account-defaults/get프로젝트 기본 계정을 읽습니다. - 프로젝트 기본 계정 교체
POST /studio-api/projects/account-defaults/replace프로젝트 기본 계정 교체. - 프로젝트 계정 연결
POST /studio-api/projects/accounts/link소셜 계정을 프로젝트에 연결합니다. - 프로젝트 계정 목록 조회
POST /studio-api/projects/accounts/list프로젝트에 연결된 계정을 조회합니다. - 프로젝트 계정 연결 해제
POST /studio-api/projects/accounts/unlink소셜 계정과 프로젝트의 연결을 해제합니다. - 프로젝트 보관
POST /studio-api/projects/archiveScheduled Posts를 변경하지 않고 프로젝트를 보관합니다. 게시물을 중지하려면 해당 Scheduled Post를 별도로 취소하세요. Workspace 소유자만 가능하며 expected_lifecycle_version과 idempotency_key를 전달하세요. - 프로젝트 에셋 연결
POST /studio-api/projects/assets/link에셋을 프로젝트에 연결합니다. - 프로젝트 에셋 목록 조회
POST /studio-api/projects/assets/list프로젝트에 연결된 에셋을 조회합니다. - 프로젝트 에셋 연결 해제
POST /studio-api/projects/assets/unlink에셋과 프로젝트의 연결을 해제합니다. - 프로젝트 생성
POST /studio-api/projects/create프로젝트를 생성합니다. - 프로젝트 내보내기 생성
POST /studio-api/projects/export/create프로젝트 내보내기를 생성합니다. - 프로젝트 내보내기 상태 조회
POST /studio-api/projects/export/status프로젝트 내보내기 상태를 읽습니다. - 프로젝트 조회
POST /studio-api/projects/get프로젝트를 읽습니다. - 프로젝트 수명 주기 이력 조회
POST /studio-api/projects/lifecycle/history프로젝트 수명 주기 이력을 읽습니다. - 프로젝트 목록 조회
POST /studio-api/projects/listWorkspace 프로젝트를 조회합니다. - 프로젝트 프로필 조회
POST /studio-api/projects/profile/get프로젝트 프로필을 읽습니다. - 프로젝트 프로필 수정
POST /studio-api/projects/profile/update프로젝트 프로필을 수정합니다. - 활성 프로젝트 설정
POST /studio-api/projects/set-active활성 프로젝트를 설정합니다. - 프로젝트 보관 해제
POST /studio-api/projects/unarchive보관된 프로젝트를 다시 활성화합니다. 게시물을 재개하거나 다시 예약하지 않으며 Scheduled Posts에서 관리해야 합니다. Workspace 소유자만 가능하며 expected_lifecycle_version과 idempotency_key를 전달하세요. - 프로젝트 수정
POST /studio-api/projects/update프로젝트를 수정합니다. - 게시 주의 사항 목록 조회
POST /studio-api/publication-attentions/list주의가 필요한 게시 결과를 확인합니다.
예약 및 게시
- 예약 게시물 일괄 생성
POST /studio-api/scheduled-posts/bulk-create여러 대상의 예약 게시물을 생성합니다. - 예약 게시물 취소
POST /studio-api/scheduled-posts/cancel예약 게시물을 취소합니다. - 예약 게시물 생성
POST /studio-api/scheduled-posts/create예약 게시물을 생성하고 최종 게시 결과를 확인합니다. - 완성된 이미지 게시물 제출
POST /studio-api/scheduled-posts/create-image-url완성된 이미지 URL 게시물 하나를 내구성 있게 접수하고 최종 결과가 있으면 반환합니다. - 예약 게시물 삭제
POST /studio-api/scheduled-posts/delete예약 게시물을 삭제합니다. - 예약 게시물 적격성 조회
POST /studio-api/scheduled-posts/eligibility예약 전에 대상의 적격성을 읽습니다. - 예약 게시물 조회
POST /studio-api/scheduled-posts/get예약 게시물 하나를 읽습니다. - 예약 게시물 목록 조회
POST /studio-api/scheduled-posts/list예약 게시물 목록 조회. - 예약 게시물 즉시 게시
POST /studio-api/scheduled-posts/publish-now즉시 게시를 요청합니다. - 예약 게시물 재시도
POST /studio-api/scheduled-posts/retry실패한 예약 게시물을 재시도합니다. - 예약 게시물 수정
POST /studio-api/scheduled-posts/update예약 게시물을 수정합니다. - 삭제 요청 철회
POST /studio-api/scheduled-posts/withdraw-delete중단된 Instagram Login 삭제 요청을 철회하고 게시된 게시물을 유지합니다. - X 게시 크레딧 조회
POST /studio-api/x/usage공유 Organization X 크레딧과 선택적 최종 Post 텍스트의 크레딧 비용을 읽습니다.
분석 및 인사이트
- 대시보드 집계 조회
POST /analytics-api/dashboard/ops-counts대시보드 운영 집계를 읽습니다. - 제공업체 인사이트 요청
POST /analytics-api/provider-insights/request제공업체가 기준인 인사이트를 요청합니다. - 제공업체 인사이트 상태 조회
POST /analytics-api/provider-insights/status제공업체 인사이트 요청 상태를 읽습니다. - 게시물 댓글 목록 조회
POST /analytics-api/social/comments/query발견된 소셜 댓글을 읽습니다. - 모니터링 게시물 목록 조회
POST /analytics-api/social/posts/query발견된 소셜 게시물을 읽습니다.
소셜 연결
- Instagram OAuth 시작
POST /oauth-api/instagram/init제공업체 동의를 시작하고 기본 인증 URL을 반환합니다. - Instagram OAuth 갱신
POST /oauth-api/instagram/refreshInstagram 연결을 갱신합니다. - Meta OAuth 시작
POST /oauth-api/meta/init제공업체 동의를 시작하고 기본 인증 URL을 반환합니다. - Meta OAuth 갱신
POST /oauth-api/meta/refreshMeta 연결을 갱신합니다. - Threads OAuth 확인
POST /oauth-api/threads/checkThreads 연결 진단 정보를 읽습니다. - Threads OAuth 시작
POST /oauth-api/threads/init제공업체 동의를 시작하고 기본 인증 URL을 반환합니다. - Threads OAuth 갱신
POST /oauth-api/threads/refreshThreads 연결을 갱신합니다. - YouTube OAuth 시작
POST /oauth-api/youtube/init제공업체 동의를 시작하고 기본 인증 URL을 반환합니다. - YouTube OAuth 갱신
POST /oauth-api/youtube/refreshYouTube 연결을 갱신합니다.
백그라운드 작업
댓글 및 커뮤니티
- 커뮤니티 작업 적용
POST /community-engagement-api/actions/apply준비된 작업을 적용하고 작업 상태에서 최종 사실을 확인합니다. - 커뮤니티 작업 준비
POST /community-engagement-api/actions/prepare최종 커뮤니티 작업을 준비합니다. - 커뮤니티 작업 상태 조회
POST /community-engagement-api/actions/status최종 작업 영수증을 읽으며 대기열 등록은 성공이 아닙니다. - 커뮤니티 기능 조회
POST /community-engagement-api/capabilitiesCommunity Engagement 기능 정보를 읽습니다. - 커뮤니티 댓글 생성
POST /community-engagement-api/comments/create정식 게시물 또는 댓글 대상에 정확한 댓글 하나를 대기열에 넣습니다. 상태는 제공업체 성공을 뜻하지 않습니다. - 댓글 전송 결과 조회
POST /community-engagement-api/comments/outcome확인된 전송, 복구 계보, 대기 중인 검증, 미해결 후속 조치를 읽습니다. - 댓글 전송 결과 대조
POST /community-engagement-api/comments/reconcile모호한 Facebook 전송을 재전송 없이 검증하거나 확인된 정확한 대체 항목 하나를 연결합니다. 최종 증거는 outcome에서 확인하세요. - 커뮤니티 댓글 상태 조회
POST /community-engagement-api/comments/status직접 댓글 작업에 대한 민감 정보를 제거한 최종 영수증을 읽습니다. - 커뮤니티 요약 조회
POST /community-engagement-api/operations/summaryCommunity Engagement 운영 요약을 읽습니다. - 커뮤니티 검토 대기열 조회
POST /community-engagement-api/review-queue/query검토 가능한 댓글을 읽으며 빈 페이지는 성공이 아닙니다. - 커뮤니티 검토 제출
POST /community-engagement-api/reviews/submit변경 불가능한 새 검토 버전을 제출합니다.
인증 초기 설정
- 에이전트 인증: config
POST /identity-api/agent-auth/config에이전트 인증 config 프로토콜. 지원되는 브라우저 로그인 흐름을 사용하고 자격 증명을 표시하지 마세요. - 에이전트 인증: request
POST /identity-api/agent-auth/request에이전트 인증 request 프로토콜. 지원되는 브라우저 로그인 흐름을 사용하고 자격 증명을 표시하지 마세요. - 에이전트 인증: revoke-current
POST /identity-api/agent-auth/revoke-current에이전트 인증 revoke-current 프로토콜. 지원되는 브라우저 로그인 흐름을 사용하고 자격 증명을 표시하지 마세요. - 에이전트 인증: session
POST /identity-api/agent-auth/session에이전트 인증 session 프로토콜. 지원되는 브라우저 로그인 흐름을 사용하고 자격 증명을 표시하지 마세요.