get__apikeys

Retrieve a list of provider API keys for a given workspace.

Request

Endpoint: GET /apikeys

Retrieves a list of available provider API keys, which can be reused when creating new storage units or configuring AI models. This endpoint requires a valid session token.

Query Parameters

Field	Type	Required	Description
workspaceId	string	Optional	The unique identifier of the workspace to filter API keys. If omitted, returns API keys across the organization that the user has access to.

Request Example

cURL

curl -X GET "https://backend.flashback.tech/apikeys?workspaceId=workspace-uuid" \
  -H "Authorization: Bearer <your-session-token>" \
  -H "Content-Type: application/json"

JavaScript

Python

Go

---

Response

Response Fields (GetProviderApiKeysResponse)

Field	Type	Description
success	boolean	Indicates whether the request was successful (true).
apiKeys	array	A list of API key objects (ProviderApiKeyDTO).

ProviderApiKeyDTO

Field	Type	Description
id	string	Unique identifier for the API key.
key	string	The public access key or identifier for the provider.
endpoint	string | undefined	The endpoint URL of the provider (if applicable).
region	string | undefined	The region of the provider (if applicable).
provider	string	The name or enum value of the provider (e.g., AWS, GCP, AZURE).
createdAt	string	ISO 8601 timestamp of when the API key was created.
bucket_count	number | undefined	The total number of active storage units/buckets using this API key.
aillm_count	number | undefined	The total number of active AI models using this API key.

Response Example (200 OK)

{
  "success": true,
  "apiKeys": [
    {
      "id": "e421a8cd-...",
      "key": "AKIAIOSFODNN7EXAMPLE",
      "endpoint": "s3.us-east-1.amazonaws.com",
      "region": "us-east-1",
      "provider": "AWS",
      "createdAt": "2024-03-08T12:00:00.000Z",
      "bucket_count": 2,
      "aillm_count": 0
    },
    {
      "id": "f8a91b2c-...",
      "key": "some-other-key",
      "provider": "GCP",
      "createdAt": "2024-03-05T08:30:00.000Z",
      "bucket_count": 1,
      "aillm_count": 1
    }
  ]
}

---

Error Responses

401 Unauthorized

Returned when the session token is missing, invalid, or the user cannot be validated.

{
  "success": false,
  "message": "User not found or not validated"
}

403 Forbidden

Returned when the user does not have permission to read buckets or API keys in the specified workspace.

{
  "success": false,
  "message": "Insufficient permissions to read API keys in this workspace"
}

500 Internal Server Error

Returned when an unexpected server error occurs.

{
  "success": false,
  "apiKeys": [],
  "message": "Internal server error"
}