How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Workera API

First-party REST API for the Workera skills-intelligence platform. Read-oriented, task-shaped endpoints expose capabilities (domains) and their competency models, programs, v2 capability scores and self-ratings, enterprise and per-capability benchmarks, and a SIEM-compatible audit-event feed. Bearer API keys are issued per company by a Workera CSM and can be restricted by scope. Cursor pagination (limit / next_page_after / order), x-ratelimit-* response headers and a machine-readable code/message/type error envelope are documented across the whole surface, alongside an HMAC-SHA256 signed webhook catalog covering assessment and program lifecycle events.

This API exposes 15 operations across 14 paths, organized into 7 resource areas, and defines 56 schemas. It is described by OpenAPI 3.0.0, at version 1.0.

Requests are made against a single base URL, https://skills.workera.ai.

15 operations 14 paths 56 schemas 14 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0
Base URL
https://skills.workera.ai/api/v1
Authentication
HTTP Bearer
Resource Areas
7

Authentication & Security 1

Workera API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (authorization). By default, every request must be authenticated.

Paths & Operations 15

Across 14 paths, the API surfaces 15 operations — 14 GET, 1 POST. They span 7 resource areas: Audit Events, Benchmarks, Domains, Ping, Programs, Scores, Self Ratings. Each is listed below with its method, path, parameters, and response codes.

Audit Events 1
GET
/api/v1/audit_events
List audit events
WorkeraWebappsWeb.Rest.Controllers.AuditEventsController.index 9 params → 200400401403429
Benchmarks 3
GET
/api/v1/benchmarks
Get benchmarks for all capabilities
WorkeraWebappsWeb.Rest.Controllers.BenchmarkController.all 1 param → 200401403429
POST
/api/v1/benchmarks
List general enterprise benchmark data
WorkeraWebappsWeb.Rest.Controllers.BenchmarkController.enterprise 1 param → 200401403429
GET
/api/v1/benchmarks/{identifier}
Get benchmarks for one capability
WorkeraWebappsWeb.Rest.Controllers.BenchmarkController.one → 200401403429
Domains 3
GET
/api/v1/domains
Get all capabilities
WorkeraWebappsWeb.Rest.Controllers.DomainController.all 3 params → 200401403429
GET
/api/v1/domains/{identifier}
Get one capability
WorkeraWebappsWeb.Rest.Controllers.DomainController.one → 200401403429
GET
/api/v1/domains/{identifier}/competency-model
Export a capability's competency model
WorkeraWebappsWeb.Rest.Controllers.DomainController.competency_model → 200401403429
Ping 1
GET
/api/v1/ping
returns a pong
WorkeraWebappsWeb.Rest.Controllers.PingController.ping → 200401403429
Programs 2
GET
/api/v1/programs
Get all programs (including drafts)
WorkeraWebappsWeb.Rest.Controllers.ProgramController.all 4 params → 200401403429
GET
/api/v1/programs/{identifier}
Get one program
WorkeraWebappsWeb.Rest.Controllers.ProgramController.one → 200401403429
Scores 3
GET
/api/v2/scores
Get all scores
WorkeraWebappsWeb.Rest.Controllers.V2.ScoresController.index 4 params → 200401403429
GET
/api/v2/scores/{score_identifier}
Get detailed score
WorkeraWebappsWeb.Rest.Controllers.V2.ScoresController.show 1 param → 200401403404429
GET
/api/v2/users/{user_identifier}/scores
Get scores for a user
WorkeraWebappsWeb.Rest.Controllers.V2.UserScoresController.index 5 params → 200401403404429
Self Ratings 2
GET
/api/v2/self-ratings
Get all self-ratings
WorkeraWebappsWeb.Rest.Controllers.V2.SelfRatingsController.index 3 params → 200401403429
GET
/api/v2/self-ratings/{rating_identifier}
Get detailed self-rating
WorkeraWebappsWeb.Rest.Controllers.V2.SelfRatingsController.show 1 param → 200401403404429

Schemas 56

The contract defines 56 schemas that model the data the API accepts and returns. The most detailed are DomainResponse (13 properties), AuditEvent (12 properties), AmbientRequirementsResponse (11 properties), V2ScoreResponse (10 properties). Each schema is shown below with its type and property counts.

BenchmarkListResponse
object
Response schema for a list of enterprise benchmark data
1 property 1 required
DomainResponse
object
Response schema for a capability
13 properties 10 required
AmbientActivityResponse
object
The effective non-regressing scan activity timestamp
2 properties 2 required
CoachingJournalResponse
object
The day's coaching-journal entry — private memory for a future coach. The client stamps the date and owns on-device storage.
1 property
AmbientSkillPicksResponse
object
The consumer's selected skill-area slugs
1 property 1 required
AmbientCoachingCardEventResponse
object
Acknowledges a metadata-only coaching-card interaction
1 property 1 required
AmbientRefreshResponse
object
A rotated per-device token pair
4 properties
AmbientMissionsResponse
object
One page of challenges assigned to the authenticated Ambient account
3 properties 3 required
DidYouKnowResponse
object
One websearch-grounded fact tied to the user's work
2 properties
MeResponse
object
The authenticated Ambient identity and status
6 properties 6 required
BenchmarkResponse
object
Response schema for a benchmark item
4 properties 1 required
AmbientScoresResponse
object
Acknowledges a monotonic score sync. sync is null on Personal; Anonymous and Visible return the canonical accepted aggregate and per-skill state.
3 properties 3 required
LearningRecommendationsResponse
object
Verified course recommendations from the enabled learning providers
1 property
AmbientScanOutcomeResponse
object
Acknowledges a stored metadata-only scan outcome
2 properties 2 required
PersonalGoalBehaviorProposalResponse
object
Six distinct, observable, privacy-safe personal-goal behaviors
1 property 1 required
AmbientRequirementsResponse
object
The authenticated account's enrollment-derived scanner skill coverage
11 properties 11 required
AmbientLanguagePreferenceUpdateResponse
object
The authenticated Ambient account's persisted output-language preference.
2 properties 2 required
CoachingCardsResponse
object
The digest cards that survived per-card validation — a subset of celebrate / activitytip / growthopportunity. The client stamps dates and dismissed flags and o…
1 property
AmbientStandingResponse
object
The caller's standing against the visible-tier cohort of its own company. Every key is always present: the four data fields are null when standing is unavailab…
6 properties 6 required
V2ScoreListResponse
object
Response schema for a paginated list of assessment scores
3 properties 3 required
CoachingProfileResponse
object
The rebuilt professional profile — a coach's mental model of the person. The client stamps the refresh watermark and version and owns on-device storage.
1 property
ProgramResponse
object
Response schema for a program
10 properties 7 required
GoalToBehaviorResponse
object
One observable behavior generated from a plain-language goal
1 property
V2SelfRatingListResponse
object
Response schema for a paginated list of self-ratings
3 properties 3 required
AmbientPresenceResponse
object
Acknowledges a metadata-only presence update
1 property
CompetencyModelExportResponse
object
The full competency model for a capability: capability → skill areas → skills → behaviors. Every node exposes only its identifier and name.
3 properties 3 required
AmbientProgramActionResult
object
Acknowledges a successful enroll / archive / unarchive on the account's membership
1 property 1 required
AmbientGraduationResponse
object
Acknowledges the device-authoritative level graduation. Personal-tier requests are successful no-ops; other tiers persist level metadata.
3 properties 3 required
AmbientLoginRequestResponse
object
Acknowledgement of a magic-link request (enumeration-safe)
1 property
AuditEvent
object
An audit event for enterprise security logging
12 properties 6 required
AmbientRegisterResponse
object
Outcome of a consumer registration attempt
1 property
ScanClassifyResponse
object
The classified scan outcome. The client resolves each artifactref back to its on-device artifact (dropping unresolved refs) and stamps the bookkeeping fields (…
6 properties 6 required
AmbientAccountDeletedResponse
object
Confirmation that the authenticated Ambient account was deleted
1 property 1 required
PongResponse
object
Response schema for a pong
1 property
CoachChatResponse
object
The next reply in a device-owned guided Coach conversation
1 property
AmbientPrivacyTierUpdateResponse
object
Result of a successful privacy-tier update. Consumer Personal updates are no-ops; enterprise updates persist the requested tier.
4 properties 4 required
AmbientOnboardingEventResponse
object
Acknowledges a stored metadata-only onboarding funnel event
1 property 1 required
ProgramListResponse
object
Response schema for a list of programs
3 properties 3 required
AmbientProfileResponse
object
The authenticated account's persisted name and effective company
4 properties 4 required
AmbientProgramsResponse
object
The authenticated account's Programs tab: enrolled, archived, and available starters
3 properties 3 required
RolePlayPromptResponse
object
The ready-to-paste role-play practice prompt for a behavior
1 property
AmbientPrivacyTierMinimumError
object
The requested enterprise tier is below the company's minimum tier
3 properties 3 required
V2SelfRatingResponse
object
Response schema for a self-rating
5 properties 5 required
ErrorResponse
object
Response schema for all errors
3 properties
AmbientTroubleshootingEvidenceResponse
object
Acknowledges a stored staff-only troubleshooting bundle
2 properties 2 required
AuditEventListResponse
object
Response schema for a paginated list of audit events
3 properties 3 required
AmbientScanTelemetryResponse
object
Acknowledges a stored metadata-only scan-telemetry record
2 properties
AmbientRevokeResponse
object
Acknowledgement of a family revocation (returned even for unknown tokens)
1 property
NextLevelBehaviorsResponse
object
The observable behaviors generated for a skill area's next level
1 property 1 required
AmbientProgressSyncResponse
object
Acknowledges current score and level synchronization under the effective privacy tier.
4 properties 4 required
AmbientOnboardingProbeResponse
object
Onboarding routing decision for an email — routing only, no account data
1 property
V2ScoreResponse
object
Response schema for an assessment score
10 properties 9 required
AmbientPrivacyResponse
object
Consumer accounts always return the fixed Personal compatibility state with zero counts. Enterprise accounts return their effective tier, raw override, company…
7 properties 7 required
AmbientMissionCompletionResponse
object
Acknowledges the first mission completion or an idempotent repeat without replacing it.
2 properties 1 required
AmbientLoginVerifyResponse
object
A verified sign-in: a fresh per-device token pair plus identity
8 properties
DomainListResponse
object
Response schema for a list of capabilities
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workera-api-openapi.json Raw ↑
Where this information came from

This is an independent, third-party profile of Workera API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.