> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Key 이름 변경과 폐기

> API Key의 이름 변경, 폐기 등 Organization admin 전용 작업을 다뤄요.

API Key는 조직 멤버 누구나 만들고 VESSL Cloud 인퍼런스 엔드포인트 호출에 쓸 수 있는, 조직 단위 자격 증명이에요. 키가 어떻게 동작하는지, 만드는 방법, 트래픽 끊김 없이 바꾸는 방법은 [API Key 관리하기](https://docs.cloud.vessl.ai/ko/inference/api-keys.md)를 참고하세요. 이 페이지는 **Organization admin** 전용 작업인 이름 변경과 폐기를 다뤄요.

## 권한

| 작업 | 할 수 있는 사람 |
| - | - |
| 키 목록 조회 | 조직에 속한 누구나 |
| 키 생성 | 조직에 속한 누구나 |
| 이름 변경 | **Organization admin**만 |
| 폐기 | **Organization admin**만 |

만든 사람 예외는 없어요. 멤버는 직접 만든 키라도 이름을 바꾸거나 폐기할 수 없어요. 멤버 화면의 **API Keys** 목록에는 **⋮** 메뉴가 보이지 않고, admin에게만 나타나요. 멤버가 키 유출을 알려 오면 admin이 대신 폐기해 주세요.

## API Key 이름 바꾸기

1. 사이드바에서 **Settings**를 선택하세요.
2. **Organization** 아래 **API Keys**를 선택하세요.
3. 키 행 끝의 **⋮** 메뉴를 열고 **Edit**를 선택하세요.
4. **API Key name**을 수정하세요.
5. **Edit**를 클릭하세요.

바꿀 수 있는 건 이름뿐이에요. 만료일은 키를 만들 때 정해지고 이후에는 바꿀 수 없어요.

## API Key 폐기하기

1. 사이드바에서 **Settings**를 선택하세요.
2. **Organization** 아래 **API Keys**를 선택하세요.
3. 키 행 끝의 **⋮** 메뉴를 열고 **Revoke**를 선택하세요.
4. 확인을 위해 키 이름을 입력하세요.
5. **Revoke**를 클릭하세요.

폐기는 되돌릴 수 없어요. 해당 키로 보내는 요청은 1분 안에 거부되기 시작하니, 아직 쓰고 있는 키라면 팀이 새 키를 만들어 애플리케이션을 먼저 옮기게 하세요. [트래픽 끊김 없이 API Key 바꾸기](https://docs.cloud.vessl.ai/ko/inference/api-keys.md#트래픽-끊김-없이-api-key-바꾸기)를 참고하세요.

폐기된 키는 **Revoked** 상태로 30일 동안 흐리게 표시된 채 목록에 남고, 그 뒤에는 목록에 표시되지 않아요. **⋮** 메뉴는 만료되거나 폐기된 키에서는 비활성화돼서 수정하거나 다시 폐기할 수 없어요.

## FAQ

> [accordion] API Key는 누가 관리할 수 있나요?
>
> 조직에 속한 누구나 키 목록을 조회하고 새 키를 만들 수 있어요. 이름 변경과 폐기는 멤버가 직접 만든 키라도 **Organization admin**만 할 수 있어서, 멤버 화면의 목록에는 **⋮** 메뉴가 보이지 않아요.

> [accordion] 키 전체 값을 다시 볼 수 있나요?
>
> 아니요. 전체 키는 키를 만들 때 **Save your API Key** 창에서 한 번만 보여요. VESSL Cloud는 키를 다시 보여 줄 수 있는 형태로 저장하지 않고, 목록에는 앞부분만 표시돼요. 키를 잃어버렸다면 새 키를 만들고 기존 키를 폐기하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.