Documentation Index
Fetch the complete documentation index at: https://docs.seleqt.ai/llms.txt
Use this file to discover all available pages before exploring further.
GET /api/v1/campaigns/
Returns a list of campaigns with optional workspace filtering.
Authentication: Session-based (JWT Cookie) OR API Key (X-API-Key header)
Query Parameters
workspace_id (string, optional): Filter campaigns by workspace
- Omit parameter: Returns campaigns from current workspace
workspace_id=123: Returns campaigns from workspace 123 (if user has access)
workspace_id=ALL: Returns campaigns from all workspaces user has access to
Security
Users can only access campaigns from workspaces they are linked to via linked_workspaces.
Response
{
"campaigns": [
{
"id": 123,
"name": "My Campaign",
"status": "ACTIVE",
"workspace_id": 340,
"timezone": "Europe/Amsterdam",
"language": "en",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"prospect_count": 150
}
]
}
Examples
Using API Key (recommended for integrations):
# Get campaigns from current workspace
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/" \
-H "X-API-Key: your_api_key_here"
# Get campaigns from specific workspace
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/?workspace_id=340" \
-H "X-API-Key: your_api_key_here"
# Get campaigns from all workspaces
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/?workspace_id=ALL" \
-H "X-API-Key: your_api_key_here"
Using Session Cookie (for web apps):
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/" \
-H "Cookie: sessionid=your_session_id"
Error Responses
403 Forbidden - User doesn’t have access to specified workspace:
{
"error": "Access denied"
}