Akun

Kelola kunci API untuk akun AgentSend Anda. Buat kunci untuk agen atau integrasi baru, daftar kunci yang ada, dan cabut kunci apa pun secara instan.

⚠

Nilai kunci API lengkap dikembalikan hanya sekali pada waktu pembuatan. Simpan dengan aman (misalnya di manajer secret atau variabel lingkungan) — tidak dapat diambil lagi.

Buat Kunci API

POST /account/api-keys

Membuat kunci API baru untuk akun yang diautentikasi. Respons mencakup string kunci lengkap; ini adalah satu-satunya waktu akan terlihat.

Body Request

Content-Type: application/json

Field	Tipe	Deskripsi
`name`	string	Label yang dapat dibaca manusia untuk kunci (misalnya `"production-agent"`). Opsional.

Contoh Request

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"}'

Respons — 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."
}

Objek CreatedApiKey

Field	Tipe	Deskripsi
`id`	string	Pengenal unik untuk kunci API.
`key`	string	Nilai kunci API lengkap. Ditampilkan hanya sekali.
`prefix`	string	Prefiks terlihat yang digunakan untuk mengidentifikasi kunci ini dalam daftar.
`name`	string \| null	Label yang dapat dibaca manusia yang disediakan saat pembuatan.
`message`	string	Pesan penasihat yang mengingatkan Anda untuk menyimpan kunci dengan aman.

Daftar Kunci API

GET /account/api-keys

Mengembalikan semua kunci API aktif di akun. Nilai kunci tidak pernah dikembalikan di endpoint ini — hanya metadata yang diekspos.

Contoh Request

bash

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

Respons — 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"
    }
  ]
}

Objek ApiKey

Field	Tipe	Deskripsi
`id`	string	Pengenal unik untuk kunci API.
`keyPrefix`	string	Prefiks terlihat kunci, digunakan untuk mengidentifikasinya tanpa mengekspos secret.
`name`	string \| null	Label yang dapat dibaca manusia, jika ditetapkan saat pembuatan.
`lastUsedAt`	string \| null	Timestamp ISO 8601 dari request terautentikasi terakhir yang dibuat dengan kunci ini.
`expiresAt`	string \| null	Timestamp kedaluwarsa ISO 8601, atau `null` jika kunci tidak kedaluwarsa.
`createdAt`	string	Timestamp ISO 8601 saat kunci dibuat.

Cabut Kunci API

DELETE /account/api-keys/{id}

Mencabut kunci API secara permanen. Request apa pun yang diautentikasi dengan kunci ini akan ditolak segera. Tindakan ini tidak dapat dibatalkan.

Parameter Path

Parameter	Tipe	Deskripsi
`id` wajib	uuid	ID kunci API yang akan dicabut.

Contoh Request

bash

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

Respons — 204 No Content

Respons kosong dengan status 204 mengonfirmasi kunci telah dicabut. Tidak ada body respons yang dikembalikan.

ℹ

Anda tidak dapat mencabut kunci yang saat ini digunakan untuk mengautentikasi request. Gunakan kunci yang berbeda (atau dasbor) untuk mencabut kunci yang sedang digunakan aktif.

← Sebelumnya API: Domain Selanjutnya → API: Lampiran