본문 바로가기
WIKI 기술 지식 베이스

조직 API 토큰 목록

원문 보기 위키 갱신

조직 API 토큰 목록 (List Organization API Tokens)

한 조직에 묶여 있는 API 토큰을 모두 조회하는 엔드포인트예요. 조직 범위 토큰과 그룹 범위 토큰이 함께 나오고, 무제한 토큰은 여기에 포함되지 않아요.

출처: 문서

본문

Returns the API tokens scoped to this organization (both organization-scoped and group-scoped). Unrestricted tokens are not returned here — manage those via GET /v1/auth/api-tokens.

인가 규칙은 폐기(revoke) 엔드포인트와 대칭을 이뤄요:

  • 관리자와 소유자는 조직에 묶인 모든 토큰을 볼 수 있고, owner 필드에 발급한 사용자가 함께 표시돼요.
  • 멤버와 뷰어는 자신이 직접 발급한 토큰만 볼 수 있어요.

이는 GitHub 조직 설정의 개인 액세스 토큰 모델과 같은 구조예요. 관리자는 전체 발급 이력 목록을, 그 외 사용자는 자신의 토큰만 보게 돼요.

이 엔드포인트는 한 조직에서 동작하는 토큰(조직 범위·그룹 범위 모두)을 나열할 때 사용해요. 관리자와 소유자는 발급자 정보가 붙은 조직의 모든 토큰을, 멤버와 뷰어는 자기 토큰만 볼 수 있어요. 호출자가 속한 모든 조직의 토큰을 나열하려면 대신 [`GET /v1/auth/api-tokens`](https://docs.turso.tech/api-reference/tokens/list)를 사용하세요. ```bash cURL theme={null} curl -L 'https://api.turso.tech/v1/organizations/{organizationSlug}/api-tokens' \ -H 'Authorization: Bearer ***' ```

OpenAPI

openapi: 3.0.1
info:
  title: Turso Platform API
  description: API description here
  license:
    name: MIT
  version: 0.1.0
servers:
  - url: https://api.turso.tech
    description: Turso's Platform API
security: []
paths:
  /v1/organizations/{organizationSlug}/api-tokens:
    get:
      summary: List Organization API Tokens
      description: >-
        Returns the API tokens scoped to this organization (both
        organization-scoped and group-scoped). Unrestricted tokens are not
        returned here — manage those via [`GET
        /v1/auth/api-tokens`](/api-reference/tokens/list).


        Authorization is symmetric with the revoke endpoint:


        - **Admins and owners** see every token scoped to the organization, with
        the minting user attached in the `owner` field.

        - **Members and viewers** see only tokens they minted themselves.


        This mirrors the personal-access-token model used in GitHub organization
        settings: admins get the full attribution list; everyone else sees their
        own access.
      operationId: listOrganizationAPITokens
      parameters:
        - $ref: '#/components/parameters/organizationSlug'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  tokens:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: The token name.
                          example: ci-bot
                        id:
                          type: string
                          description: The token ID. Pass this to the revoke endpoint.
                          example: clGFZ4STEe6fljpFzIum8A
                        organization:
                          type: string
                          description: >-
                            The organization slug. Always equal to the path
                            parameter for tokens returned here.
                          example: my-org
                        group:
                          type: string
                          description: >-
                            The group name. Present only for group-scoped
                            tokens.
                          example: default
                        scopes:
                          type: array
                          items:
                            type: string
                          description: >-
                            The expanded scope list. Present only for
                            group-scoped tokens.
                          example:
                            - db:create
                            - db:configure
                            - db:mint-token
                        owner:
                          type: object
                          properties:
                            username:
                              type: string
                              example: alice
                            email:
                              type: string
                              example: [email protected]
                          description: >-
                            The user who minted the token. Returned to admins
                            and owners so they can see who provisioned each
                            token.
                        created_at:
                          type: string
                          description: The date the token was created.
                          example: '2026-05-21'
components:
  parameters:
    organizationSlug:
      in: path
      name: organizationSlug
      required: true
      schema:
        type: string
      description: The slug of the organization or user account.

더 알아보기 (Learn more)