계정

AgentSend 계정의 API 키를 관리합니다. 새 에이전트나 통합용 키를 생성하고, 기존 키를 나열하고, 어떤 키든 즉시 취소합니다.

⚠

전체 API 키 값은 생성 시 한 번만 반환됩니다. 안전하게 저장하세요 (예: 시크릿 매니저 또는 환경 변수) — 다시 가져올 수 없습니다.

API 키 생성

POST /account/api-keys

인증된 계정에 대해 새 API 키를 생성합니다. 응답에는 전체 키 문자열이 포함됩니다; 이것이 유일하게 볼 수 있는 시점입니다.

요청 본문

Content-Type: application/json

필드	타입	설명
`name`	string	키의 사람이 읽을 수 있는 레이블 (예: `"production-agent"`). 선택 사항.

요청 예시

bash

curl -X POST https://api.agentsend.io/account/api-keys \
  -H "x-api-key: $AGENTSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-agent"}'

응답 — 201 Created

json

{
  "id": "ak_01j9zxkp4qbc7n3m8td5e6fvg2",
  "key": "as_live_v1_4xKqT2mNpRuWsYcBjDeGhLzA...",
  "prefix": "as_live_v1_4xKq",
  "name": "production-agent",
  "message": "Store this key securely. It will not be shown again."
}

CreatedApiKey 객체

필드	타입	설명
`id`	string	API 키의 고유 식별자.
`key`	string	전체 API 키 값. 한 번만 표시됩니다.
`prefix`	string	목록에서 이 키를 식별하는 데 사용되는 표시 접두사.
`name`	string \| null	생성 시 제공된 사람이 읽을 수 있는 레이블.
`message`	string	키를 안전하게 저장하도록 상기시키는 권고 메시지.

API 키 목록

GET /account/api-keys

계정의 모든 활성 API 키를 반환합니다. 이 엔드포인트에서는 키 값이 반환되지 않으며, 메타데이터만 노출됩니다.

요청 예시

bash

curl https://api.agentsend.io/account/api-keys \
  -H "x-api-key: $AGENTSEND_API_KEY"

응답 — 200 OK

json

{
  "data": [
    {
      "id": "ak_01j9zxkp4qbc7n3m8td5e6fvg2",
      "keyPrefix": "as_live_v1_4xKq",
      "name": "production-agent",
      "lastUsedAt": "2025-11-02T14:23:00Z",
      "expiresAt": null,
      "createdAt": "2025-10-15T09:00:00Z"
    },
    {
      "id": "ak_02k0aylq5rcd8o4n9ue6f7gwh3",
      "keyPrefix": "as_live_v1_9mHr",
      "name": null,
      "lastUsedAt": null,
      "expiresAt": "2026-01-01T00:00:00Z",
      "createdAt": "2025-12-01T10:30:00Z"
    }
  ]
}

ApiKey 객체

필드	타입	설명
`id`	string	API 키의 고유 식별자.
`keyPrefix`	string	시크릿을 노출하지 않고 키를 식별하는 데 사용되는 표시 접두사.
`name`	string \| null	생성 시 설정된 사람이 읽을 수 있는 레이블 (있는 경우).
`lastUsedAt`	string \| null	이 키로 수행된 마지막 인증 요청의 ISO 8601 타임스탬프.
`expiresAt`	string \| null	ISO 8601 만료 타임스탬프 또는 키가 만료되지 않는 경우 `null`.
`createdAt`	string	키가 생성된 ISO 8601 타임스탬프.

API 키 취소

DELETE /account/api-keys/{id}

API 키를 영구적으로 취소합니다. 이 키로 인증된 모든 요청은 즉시 거부됩니다. 이 작업은 취소할 수 없습니다.

경로 파라미터

파라미터	타입	설명
`id` 필수	uuid	취소할 API 키의 ID.

요청 예시

bash

curl -X DELETE https://api.agentsend.io/account/api-keys/ak_01j9zxkp4qbc7n3m8td5e6fvg2 \
  -H "x-api-key: $AGENTSEND_API_KEY"

응답 — 204 No Content

상태 204인 빈 응답이 키가 취소되었음을 확인합니다. 응답 본문이 반환되지 않습니다.

ℹ

현재 요청을 인증하는 데 사용되는 키는 취소할 수 없습니다. 활성 사용 중인 키를 취소하려면 다른 키(또는 대시보드)를 사용하세요.

← 이전 API: 도메인 다음 → API: 첨부파일