API 개요
워크스페이스의 채용 공고, 지원서, 후보자, 채용 지표를 내 시스템에서 읽고 바꾸세요.
Tahoe API는 Tahoe 워크스페이스의 채용 공고, 지원서, 후보자, 파이프라인을 다루는 HTTP API입니다. 변경 사항을 따라갈 수 있는 변경 피드와 웹훅을 제공하고, 사용자가 이미 가진 Tahoe 계정으로 로그인할 수 있도록 Sign in with Tahoe도 제공합니다.
기본 URL과 버전
모든 환경에서 기본 URL은 하나입니다: https://tahoe.workonward.com/api/partner/v1. 별도의 샌드박스 호스트는 없습니다. test 키와 live 키는 같은 경로로 같은 워크스페이스를 읽으며, 로그에서는 키의 접두사로 둘을 구분합니다.
모든 응답의 Tahoe-Api-Version 헤더에 API 버전이 담기며, GET /ping은 키 없이도 버전을 알려 줍니다. 버전은 날짜 형식이고, 호환되지 않는 변경이 있을 때만 바뀝니다. 새 필드, 엔드포인트, 이벤트 유형은 버전 변경 없이 추가됩니다.
시작하기 전에 알아 둘 세 가지
읽기가 기본이고, 허용한 곳에서만 씁니다
대부분의 엔드포인트는 GET입니다. 입력값이 크거나 민감해서 쿼리 문자열에 담기 어려운 두 가지 읽기 요청만 POST를 씁니다: /people/resolve:batch와 /pool/search.
쓰기는 따로 있으며, 각각 자체 스코프가 필요하고 그 스코프는 유료 요금제 스코프입니다. 채용 공고를 푸시하고, 공고를 게시, 마감, 재개하고, 공고에 후보자를 추가하고, 지원서를 옮기거나 탈락시키거나 탈락을 취소하거나 메모를 남기고, 지원한 사람에게 이메일을 보내고, 리스트를 만들어 채우고, 내 웹훅 엔드포인트를 등록할 수 있습니다. 쓰기는 키를 만든 사람이 한 것으로 기록되어 리크루터가 볼 수 있으며, 쓰는 것은 API 키입니다. Sign in with Tahoe 토큰은 연결된 앱의 쓰기가 켜져 있을 때만 씁니다. API가 하는 어떤 일도 데이터를 삭제하지 않으며, POST /messages를 통하지 않고는 후보자에게 아무것도 가지 않습니다. 재시도가 쓰기를 두 번 하지 않도록 쓰기에 Idempotency-Key를 보내세요. 쓰기를 하는 스코프를 참고하세요.
개인 데이터는 사용량을 측정하고 기록합니다
이메일, 전화번호, 이력서는 별도 스코프로 보호되며, 하나를 읽을 때마다 키, 레코드, 필드가 기록됩니다. 개인 정보에는 요청 속도 제한과 별개로 하루 한도가 있습니다. 그래서 채용 공고는 하루 종일 조회할 수 있어도 전화번호를 대량으로 복사할 수는 없습니다.
API는 워크스페이스가 Tahoe에서 아직 열람하지 않은 연락처를 넘겨주지 않습니다. 열람한 적 없는 필드는 이유와 함께 제공되지 않는다고 표시되며, 조용히 빈 값으로 오지 않습니다.
리크루터가 볼 수 없는 정보는 보여 주지 않습니다
API는 한 워크스페이스의 자체 데이터를 보여 주는 창입니다. 다른 고객의 데이터나 전화 스크리닝 내용으로 들어가는 통로가 아닙니다. API에서 아예 다루지 않는 항목은 절대 공개되지 않는 정보에서 확인하세요.
읽고 바꿀 수 있는 데이터
| 영역 | 제공 내용 | 주요 스코프 |
|---|---|---|
| Jobs | 채용 공고, 공고 섹션, 지원서 양식, 파이프라인 단계, 사전 스크리닝 질문. 공고를 푸시하고, 공고를 게시, 게시 취소, 마감, 재개 | jobs:read, jobs:write, jobs:manage |
| Applications | 지원서, 단계와 상태, 양식 답변, 매칭 점수, 단계 이력, 이력서. 지원서 이동, 탈락 처리, 탈락 취소, 메모 | applications:read, applications:write, notes:write, scorecards:write |
| Create an application | 이력서를 올리고 내 시스템의 후보자를 공고에 추가 | applications:write |
| Messages | 수신 거부 링크와 일일 한도가 적용되는, 지원한 사람에게 보내는 이메일 | messages:send |
| Applicants | 지원한 사람과 그 사람의 지원서, 이력서, 연락처 | applicants:read |
| Sourced profiles | 워크스페이스가 찾아 저장한 후보자와 열람한 연락처, 첨부 파일 | sourced_profiles:read |
| Shared pool | Tahoe가 이미 보유한 공개 경력 프로필과, 이를 무료로 검색하는 기능 | pool:read |
| People | 이메일이나 LinkedIn URL로 자체 레코드를 Tahoe의 인물과 연결 | people:resolve |
| Projects and lists | 프로젝트, 후보자 리스트, 구성원과 단계. 리스트 만들고 채우기 | lists:read, lists:write |
| Analytics | 채용 퍼널 합계, 단계별 소요 시간, 채용까지 걸린 시간 | analytics:read |
| Events | 변경 피드, 삭제 통지, 내 웹훅 엔드포인트와 전송 상태 | events:read, webhooks:read, webhooks:write |
| Sign in with Tahoe | PKCE를 사용하는 표준 OpenID Connect 로그인 | API 키 불필요 |
사용 권한 받기
워크스페이스의 소유자와 관리자가 설정의 개발자 탭에서 API 키를 만듭니다. 필요한 스코프와 기간을 고르면 키가 그 워크스페이스를 읽습니다. 쓰기 스코프에는 유료 요금제가 필요합니다. 개발자 탭이 보이지 않는 경우에는 [email protected]으로 문의해 주세요.
첫 요청 보내기
GET /me는 지금 가진 키로 무엇을 할 수 있는지 정확히 알려 줍니다. 스코프, 접근할 수 있는 워크스페이스, 워크스페이스를 지정해야 하는지 여부, 현재 한도를 확인할 수 있습니다. 설정 문제인지 코드 문제인지 가장 빨리 구분하는 방법입니다.
curl https://tahoe.workonward.com/api/partner/v1/me \
-H "Authorization: Bearer $TAHOE_API_KEY"{
"object": "credential",
"id": "pk_9tRc4mQx7Lb2",
"name": "Acme HRIS sync",
"environment": "live",
"scopes": ["applications:read", "jobs:read", "workspaces:read"],
"scope_descriptions": {
"applications:read": "Applications, their stage and status, and match scores.",
"jobs:read": "Job postings, their content, application forms and pipeline stages.",
"workspaces:read": "Workspace name and creation date."
},
"workspace_scope": "list",
"workspace_ids": ["wsp_4Kd8sPm2Qx7L"],
"workspace_id_required": false,
"rate_limits": {
"general_per_minute": 600,
"expensive_per_minute": 60,
"download_per_minute": 30,
"personal_data_reads_per_day": 5000,
"personal_data_reads_used_today": 128,
"max_page_size": 100,
"max_result_window": 10000
},
"created_at": "2026-09-09T10:14:22.510Z",
"expires_at": "2026-12-08T10:14:22.510Z",
"api_version": "2026-09-09"
}도움 받기
모든 응답에는 Tahoe-Request-Id 헤더가 있습니다. 문의할 때 함께 보내 주시면 해당 요청을 정확히 찾을 수 있습니다.