본문으로 건너뛰기

워크스페이스

현재 토큰이 속한 워크스페이스의 기본 정보를 읽는 조회 API입니다. 토큰이 어느 워크스페이스에 연결돼 있는지 확인할 때 가장 먼저 호출해 볼 수 있습니다.

워크스페이스 조회​

GET /workspace — 현재 토큰이 속한 워크스페이스의 메타 정보를 조회합니다.

  • Scope: workspaces:read (모든 토큰에 자동 포함)
  • 쿼리·바디: 없음

아래 요청은 토큰이 속한 워크스페이스를 조회합니다.

curl https://api.talk.zeroworks.ai/api/public/v1/workspace \
-H "Authorization: Bearer ztpat_..."

응답

{
"success": true,
"data": {
"id": "5f3e8c10-...",
"name": "Acme Inc",
"created_at": "2026-01-01T00:00:00Z"
}
}

필드​

필드타입설명
idstring워크스페이스 UUID
namestring워크스페이스 이름
created_atstring생성 시각 (RFC 3339)

워크스페이스가 삭제된 상태에서 요청하면 404 NOT_FOUND를 반환합니다.