워크스페이스와 사용자
키로 읽을 수 있는 워크스페이스와 멤버.
워크스페이스는 Tahoe 고객 계정 하나로, 자체 채용 공고, 후보자, 팀을 가집니다. 다른 모든 엔드포인트는 정확히 하나의 워크스페이스 안에서 데이터를 읽습니다. 아래 네 엔드포인트는 키가 접근할 수 있는 워크스페이스와 그 안에서 일하는 사람을 알려 줍니다.
GET/workspacesworkspaces:read
키가 접근할 수 있는 모든 워크스페이스입니다. 대부분의 키는 한 행만 돌려받습니다. 교차 워크스페이스 키라면 다른 호출에서 ?workspace_id=로 보낼 수 있는 값의 목록이 됩니다. 다른 목록과 마찬가지로 limit과 cursor로 페이지를 나눕니다.
요청
curl https://tahoe.workonward.com/api/partner/v1/workspaces \
-H "Authorization: Bearer $TAHOE_API_KEY"응답
{
"object": "list",
"data": [
{
"object": "workspace",
"id": "wsp_4Kd8sPm2Qx7L",
"name": "Kestrel Labs Talent",
"created_at": "2025-11-04T08:12:44.201Z",
"updated_at": "2026-09-02T16:40:03.118Z",
"links": {
"self": "/api/partner/v1/workspaces/wsp_4Kd8sPm2Qx7L",
"users": "/api/partner/v1/workspaces/wsp_4Kd8sPm2Qx7L/users",
"jobs": "/api/partner/v1/jobs?workspace_id=wsp_4Kd8sPm2Qx7L"
}
}
],
"has_more": false,
"next_cursor": null
}GET/workspaces/{workspace_handle}workspaces:read
위의 행과 같은 형태의 워크스페이스 하나입니다. 키가 접근할 수 없는 핸들은 403이 아니라 404를 반환합니다. 워크스페이스가 존재하지만 내 것이 아니라고 알려 주는 것 자체가 정보 유출이기 때문입니다.
GET/workspaces/{workspace_handle}/usersusers:read
워크스페이스의 멤버와 역할입니다. Tahoe 리크루터를 자체 시스템의 사용자와 연결해, 미러링한 활동이 올바른 사람에게 기록되도록 할 때 쓰세요. 팀은 규모가 작으므로 멤버 전체가 한 페이지로 오고 next_cursor는 항상 null입니다.
요청
curl https://tahoe.workonward.com/api/partner/v1/workspaces/wsp_4Kd8sPm2Qx7L/users \
-H "Authorization: Bearer $TAHOE_API_KEY"응답
{
"object": "list",
"data": [
{
"object": "user",
"id": "usr_2Pq7mKd4Rx8v",
"workspace_id": "wsp_4Kd8sPm2Qx7L",
"email": "[email protected]",
"first_name": "Jordan",
"last_name": "Rivera",
"is_verified": true,
"role": "owner",
"photo_url": null,
"created_at": "2025-11-04T08:12:44.201Z",
"updated_at": "2026-09-30T09:15:27.402Z",
"last_login_at": "2026-10-06T13:02:51.774Z",
"links": { "self": "/api/partner/v1/users/usr_2Pq7mKd4Rx8v" }
},
{
"object": "user",
"id": "usr_8Xn3qLw5Tz2c",
"workspace_id": "wsp_4Kd8sPm2Qx7L",
"email": "[email protected]",
"first_name": "Sam",
"last_name": "Okafor",
"is_verified": true,
"role": "member",
"photo_url": null,
"created_at": "2026-02-11T15:20:09.330Z",
"updated_at": "2026-09-12T10:44:18.006Z",
"last_login_at": "2026-10-05T08:31:40.912Z",
"links": { "self": "/api/partner/v1/users/usr_8Xn3qLw5Tz2c" }
}
],
"has_more": false,
"next_cursor": null
}| 필드 | 의미 |
|---|---|
role | 이 워크스페이스에서 멤버의 역할입니다. owner, admin, member, viewer 중 하나입니다. |
is_verified | 멤버가 이메일 주소를 인증했는지 여부입니다. |
last_login_at | 마지막으로 Tahoe에 로그인한 시점입니다. 없으면 null입니다. |
GET/users/{user_handle}users:read
위의 행과 같은 형태의 사용자 한 명입니다. 이전에 저장한 usr_ 핸들이 누구인지 확인할 때 쓰세요. 사용자는 요청이 가리키는 워크스페이스에 속해야 합니다(교차 워크스페이스 키라면 ?workspace_id=를 넣으세요). 그 밖의 사용자는 404를 반환합니다.
요청
curl https://tahoe.workonward.com/api/partner/v1/users/usr_8Xn3qLw5Tz2c \
-H "Authorization: Bearer $TAHOE_API_KEY"