List API Keys - Byteport

GET

tokens

curl https://api.byteport.com/v1/tokens \
  -H "Authorization: Bearer $BYTEPORT_API_KEY" \
  -H "User-Agent: my-app/1.0"

const res = await fetch("https://api.byteport.com/v1/tokens", {
  headers: {
    Authorization: `Bearer ${process.env.BYTEPORT_API_KEY}`,
    "User-Agent": "my-app/1.0",
  },
});
const keys = await res.json(); // an array

import os, requests

keys = requests.get(
    "https://api.byteport.com/v1/tokens",
    headers={
        "Authorization": f"Bearer {os.environ['BYTEPORT_API_KEY']}",
        "User-Agent": "my-app/1.0",
    },
).json()  # a list

[
  {
    "id":         "9b7e2c1a-4f3d-4a2b-8c1e-2d6f5a0b7c34",
    "name":       "production-pipeline",
    "created_at": "2026-05-14T17:02:11Z"
  },
  {
    "id":         "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
    "name":       "ci-temporary",
    "created_at": "2026-04-02T09:18:44Z",
    "expires_at": "2026-07-01T00:00:00Z",
    "revoked_at": "2026-04-20T12:00:00Z"
  }
]

List every API key in the authenticated workspace, ordered newest first. The response is a JSON array (not an object). Revoked keys are included with revoked_at set, so you can render a complete audit view. Raw token secrets are never returned.

curl https://api.byteport.com/v1/tokens \
  -H "Authorization: Bearer $BYTEPORT_API_KEY" \
  -H "User-Agent: my-app/1.0"

const res = await fetch("https://api.byteport.com/v1/tokens", {
  headers: {
    Authorization: `Bearer ${process.env.BYTEPORT_API_KEY}`,
    "User-Agent": "my-app/1.0",
  },
});
const keys = await res.json(); // an array

import os, requests

keys = requests.get(
    "https://api.byteport.com/v1/tokens",
    headers={
        "Authorization": f"Bearer {os.environ['BYTEPORT_API_KEY']}",
        "User-Agent": "my-app/1.0",
    },
).json()  # a list

[
  {
    "id":         "9b7e2c1a-4f3d-4a2b-8c1e-2d6f5a0b7c34",
    "name":       "production-pipeline",
    "created_at": "2026-05-14T17:02:11Z"
  },
  {
    "id":         "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
    "name":       "ci-temporary",
    "created_at": "2026-04-02T09:18:44Z",
    "expires_at": "2026-07-01T00:00:00Z",
    "revoked_at": "2026-04-20T12:00:00Z"
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

The workspace's API keys, ordered by created_at descending.

string

Unique identifier for the key (a UUID). Use it as the {id} path segment for Retrieve, Update, and Delete.

Example:

"9b7e2c1a-4f3d-4a2b-8c1e-2d6f5a0b7c34"

name

string

The human-readable label set at creation or via Update.

Example:

"production-pipeline"

created_at

string<date-time>

When the key was created (RFC 3339, UTC).

Example:

"2026-05-14T17:02:11Z"

expires_at

string<date-time>

When the key expires. Omitted entirely if the key never expires.

Example:

"2026-12-31T23:59:59Z"

revoked_at

string<date-time>

When the key was revoked. Omitted entirely while the key is active.

Example:

"2026-04-20T12:00:00Z"

Create API Key

Retrieve API Key

curl https://api.byteport.com/v1/tokens \
  -H "Authorization: Bearer $BYTEPORT_API_KEY" \
  -H "User-Agent: my-app/1.0"

const res = await fetch("https://api.byteport.com/v1/tokens", {
  headers: {
    Authorization: `Bearer ${process.env.BYTEPORT_API_KEY}`,
    "User-Agent": "my-app/1.0",
  },
});
const keys = await res.json(); // an array

import os, requests

keys = requests.get(
    "https://api.byteport.com/v1/tokens",
    headers={
        "Authorization": f"Bearer {os.environ['BYTEPORT_API_KEY']}",
        "User-Agent": "my-app/1.0",
    },
).json()  # a list

[
  {
    "id":         "9b7e2c1a-4f3d-4a2b-8c1e-2d6f5a0b7c34",
    "name":       "production-pipeline",
    "created_at": "2026-05-14T17:02:11Z"
  },
  {
    "id":         "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
    "name":       "ci-temporary",
    "created_at": "2026-04-02T09:18:44Z",
    "expires_at": "2026-07-01T00:00:00Z",
    "revoked_at": "2026-04-20T12:00:00Z"
  }
]