Docs
⌘K
Account, keys and webhooks ›

List api keys

GET/v1/api-keys

Your keys: what each may do and where, and when and from where each was last used.

RequestTypeScript
  1. import { Agental } from "agental-sdk";
  3. const agental = new Agental();
  4. const keys = await agental.apiKeys.list();
Answer200 OK
  1. {
  2. "apiKeys": [{
  3. "id": string,
  4. "name": string,
  5. "prefix": string | null,
  6. "createdAt": string,
  7. "seesAll": boolean,
  8. "preset": "read-only" | "full-sandbox" | "ci" | "admin" | "null" | null,
  9. … 9 more
  10. }],
  11. }

The keys of the organization the caller acts in, oldest first: in a team, every key of it for an owner or admin, and a member's own for a member.

Headers

Authorizationrequired
Bearer key
An API key that may make this call.

Returns

200 The keys of the organization the caller acts in, oldest first: in a team, every key of it for an owner or admin, and a member's own for a member. The secrets are never returned.

JSON1 field
apiKeys
ApiKey[]15 fields
id
string
name
string
prefix
stringnull
The first characters of the secret, to tell keys apart by.
More Null for a key from before they were kept.
createdAt
string
seesAll
boolean
True for a key of whoever runs the service, which sees every account.
preset
read-onlyfull-sandboxciadminnullnull
The preset the key was made with.
More Null for one made with its actions named.
actions
string[]
What the key may do, as it was made: a preset is written out into its actions then, so a preset that grows later does not widen it.
More * is everything.
sandboxIds
string[]
The sandboxes the key is limited to, with templateIds.
More Empty, with templateIds empty too, is every sandbox of the account.
templateIds
string[]
The templates the key is limited to: it reaches them and every sandbox on them.
More Empty is every template, and, with sandboxIds empty too, every sandbox.
expiresAt
stringnull
When the key stops working.
More Null is never.
allowFrom
string[]
The addresses and ranges the key may be used from.
More Empty is anywhere.
lastUsedAt
stringnull
When the key was last used, to the minute: it is written once a minute at most.
More Null if never.
lastUsedFrom
stringnull
The address it was last used from.
organizationId
stringnull
The organization the key acts in: the one it was made in, for good.
More Null for a key of whoever runs the service.
createdBy
stringnull
The account that made it.
More In a team, its owners and admins see every key of the team, and a member only those they made.
← Set heardCreate api key →