Skip to main content
The Exec API provides programmatic access to your workspace data. Use it to integrate Exec with your internal tools, build custom dashboards, automate training workflows, or power AI agents that manage your enablement programs.

​
What You Can Do

Practice Data

Pull roleplay session data with scores, transcripts, and evaluation feedback

Skills & Proficiency

Track skill proficiency across your team with time-decay weighted scoring

Assignments

Monitor assignment status, completion, and scores

Scenario Analytics

Get aggregate performance metrics, participant tables, and rank distributions

Collections

List collections and filter scenarios by collection

Scenario Management

List scenarios, filter by skill, check access, and assign to users

Scenario Studio

Create scenarios programmatically or via interactive sessions

Workspace Data

Access members, groups, and workspace configuration

​
Base URL

All API requests use the following base URL: 
https://api.exec.com/rest/v1/

​
Authentication

Every request requires an API key in the Authorization header: 
Authorization: Bearer exec_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Get Started with Authentication

Learn how to create and use API keys

​
Response Format

All responses are JSON. List endpoints return paginated data: 
{
  "data": [...],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_count": 128,
    "total_pages": 3
  }
}
Errors return appropriate HTTP status codes with structured error information: 
{
  "error": {
    "type": "invalid_request",
    "code": "user_not_found",
    "message": "No user found with email: [email protected]"
  }
}

​
Rate Limits

API requests are rate-limited to ensure service stability:
  • Burst limit: 60 requests per minute
  • Sustained limit: 1,000 requests per day
  • Scenario creation: 10 requests per minute (higher cost operations)
Rate-limited responses return 429 with a retry_after field indicating when to retry.

​
Filtering Tips

Most analytics endpoints accept these common filters:
  • user_ids / user_emails — filter by specific users (emails are resolved server-side)
  • group_ids — filter by workspace group membership
  • scenario_ids / collection_ids — filter by specific scenarios or collections
  • skill_ids — filter by skills evaluated
  • start_date / end_date — filter by date range (ISO 8601)
All ID parameters accept UUIDs (the same IDs returned by list endpoints).

​
Coming Soon

We’re actively expanding the API. Planned additions include:
  • Program management and reporting
  • Webhook integrations for real-time events
  • Call scoring data
Contact us at [email protected] if you have specific API needs.