List my API keys
List metadata for keys owned by the current WorkspaceAPI actor. Raw secrets are never returned after creation or rotation.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1/workspaces/{workspace_id}
Authentication: bearer. Required scope: api_keys:read.
GET /api-keys
List metadata for keys owned by the current WorkspaceAPI actor. Raw secrets are never returned after creation or rotation.
curl --fail-with-body -X GET "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/api-keys" \
-H "Authorization: Bearer $SYM_WORKSPACE_API_KEY"{
"worker_id": "worker-example-001",
"org_id": "workspace_example",
"items": [
{
"id": "key_01J8",
"name": "Local integration",
"prefix": "sym_ws_x7K2",
"last_four": "9Qpf",
"scopes": [
"files:read",
"chats:read"
],
"last_used_at": "2026-08-04T10:30:00Z",
"expires_at": null
}
],
"scopes": [
"workspace:read",
"api_keys:read"
],
"ok": true
}Authorization
{
"type": "bearer",
"scope": "api_keys:read",
"transport": "Authorization: Bearer <workspace_api_key>"
}Errors
| Status | Description |
|---|---|
| 401 | The workspace API key is missing, invalid, expired, or revoked. |
| 403 | The key lacks the required scope or its owner no longer has permission. |
| 429 | The key exceeded its current rate limit. |
Usage notes
- Only keys owned by the current user in this workspace are returned.
- The scopes catalog is intersected with the caller's own scopes and current workspace permissions.