API Keys
List API Keys
List every API key in your workspace.
GET
/
v1
/
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
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.
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"
The human-readable label set at creation or via Update.
Example:
"production-pipeline"
When the key was created (RFC 3339, UTC).
Example:
"2026-05-14T17:02:11Z"
When the key expires. Omitted entirely if the key never expires.
Example:
"2026-12-31T23:59:59Z"
When the key was revoked. Omitted entirely while the key is active.
Example:
"2026-04-20T12:00:00Z"
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"
}
]