워크스페이스 목록

01 워크스페이스 목록

1.1 설명

GET/workspaces

순서는 만든 차례입니다.

1.2 파라미터

워크스페이스 목록 파라미터
이름	구분	설명
`page`	선택	쪽 번호. 기본 1
`limit`	선택	쪽 크기. 기본 20, 최대 100
`offset`	선택	`page` 대신 시작 위치를 직접 지정합니다

1.3 요청

Terminal — bash

curl "https://moacast.com/api/moacast/v1/workspaces?page=1" \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

1.4 성공 응답

Response — JSON

{
    "result": "SUCCESS",
    "result_code": 0,
    "data": {
        "workspaces": [
            {
                "code": "a1b2c3d4",
                "name": "My Workspace",
                "timezone": "Asia/Seoul",
                "status": "ACTIVE",
                "created_at": "2026-09-25 23:13:51"
            }
        ],
        "pagination": {
            "mode": "page",
            "page": 1,
            "limit": 20,
            "total": 1,
            "total_pages": 1,
            "has_more": false
        }
    }
}

1.5 필드

워크스페이스 목록 필드
필드	타입	설명
`workspaces`	`array`	워크스페이스 목록. 한 줄의 모양은 아래와 같습니다
`pagination`	`object`	페이징 정보. `has_more` 가 true 이면 다음 쪽이 있습니다

workspaces 의 한 줄

워크스페이스 목록 필드
필드	타입	설명
`code`	`string`	워크스페이스를 가리키는 공개 식별자입니다. 다른 엔드포인트가 이 값을 받습니다
`name`	`string`	이름
`timezone`	`string`	예약 발행의 기준이 되는 시간대
`status`	`string`	`ACTIVE` 또는 `SUSPENDED`. `SUSPENDED` 는 보이지만 발행이 막힌 상태입니다
`created_at`	`string`	만든 시각. UTC 기준 `YYYY-MM-DD HH:MM:SS`

1.6 실패

워크스페이스 목록 실패
코드	HTTP	언제
`1001`	401	헤더가 없거나 토큰이 올바르지 않습니다 (만료는 4013 · 키 폐기는 4014)

토큰을 받은 뒤 그 워크스페이스가 지워졌거나 남에게 넘어갔으면 목록에서 조용히 빠집니다. 오류로 알려 주지 않습니다.