tokens

Get detailed information for a specific token

Retrieve comprehensive details about an API token including its permissions, usage statistics, and configuration. This endpoint is useful for auditing token access and monitoring usage.

Access Control

Users can view details for their own tokens
Administrators can view any token in their organization

Token Scopes

Scopes define what operations a token can perform:

experiments:read: View experiment data
experiments:write: Create and modify experiments
reports:read: Access report data
targets:read: View target catalog
tokens:write: Manage API tokens
users:read: View user information
invoices:read: Access billing information

Metadata Fields

The metadata object may contain:

ip_whitelist: Array of allowed IP addresses/ranges
description: Detailed description of token purpose
environment: Target environment (production, staging, etc.)
webhook_url: URL for token usage notifications

Usage Monitoring

Check usage_count to monitor API activity
Review last_used to identify inactive tokens
Set up alerts for unusual usage patterns

Security Considerations

The actual token value is never returned
Tokens inherit user permissions but can be scoped down
IP whitelisting adds an extra security layer
Regular audits help maintain security

GET

tokens

{token_id}

curl --request GET \
  --url https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws/tokens{token_id} \
  --header 'Authorization: Bearer <token>'

{
  "created_at": "<string>",
  "created_by": "<string>",
  "created_by_name": "<string>",
  "expires_at": "<string>",
  "id": "<string>",
  "last_used": "<string>",
  "metadata": "<any>",
  "name": "<string>",
  "scopes": [
    "<string>"
  ],
  "status": "<string>",
  "token_type": "<string>",
  "usage_count": 1
}

Authorizations

Authorization

string

header

required

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

Path Parameters

token_id

string

required

Unique identifier of the token to retrieve

Response

200

application/json

Successfully retrieved token information

Detailed information about a specific API token

Provides comprehensive details about a token including its permissions, usage statistics, and metadata. The actual token value is never included for security reasons.

Create a new API token for programmatic access Get real-time updates from all experiments

curl --request GET \
  --url https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws/tokens{token_id} \
  --header 'Authorization: Bearer <token>'

{
  "created_at": "<string>",
  "created_by": "<string>",
  "created_by_name": "<string>",
  "expires_at": "<string>",
  "id": "<string>",
  "last_used": "<string>",
  "metadata": "<any>",
  "name": "<string>",
  "scopes": [
    "<string>"
  ],
  "status": "<string>",
  "token_type": "<string>",
  "usage_count": 1
}

🚧 Foundry API (Alpha) 🚧

Authorizations

Path Parameters

Response