DocumentationPlatform ServicesOverview

Platform Services

Beyond the EDM data domains, cPod exposes a set of cross-cutting platform services available to every application built on the platform. These services handle operational concerns — running logic, orchestrating steps, tracking changes, protecting data, and controlling feature rollout — so your application code stays focused on its domain.


Services at a Glance

ServiceSDK namespaceWhat it does
Skillssdk.skillsRun pre-built or custom analytical functions against EDM data
Workflowssdk.workflowsDefine and trigger multi-step orchestration sequences
Jobssdk.jobsSubmit async work units, monitor progress, retrieve output
Data Maskingsdk.maskingMask PII and sensitive values for safe downstream use
Telemetrysdk.telemetryAudit trail, LLM traces, and app analytics — all auto-instrumented
Feature Flagssdk.flagsEvaluate feature flags with per-tenant and per-user context
Secretssdk.secretsResolve secret keys to values without storing credentials in code

Common Patterns

Async by default

Services that perform significant work (skills, workflows, syncs) return a Job handle immediately and run asynchronously. Use sdk.jobs.wait() to block until completion, or sdk.jobs.get() to poll manually.

const job = await sdk.skills.run('access-review', { groupId: 'grp-abc123' })
const result = await sdk.jobs.wait(job.id)
// result.status → 'completed'
// result.output → skill-specific payload

Consistent error shape

All SDK methods throw structured errors:

try {
  await sdk.flags.evaluate('new-dashboard', { tenantId: 'ten-abc' })
} catch (err) {
  console.log(err.code)    // e.g. "not_found", "permission_denied"
  console.log(err.message) // human-readable
  console.log(err.status)  // HTTP status code
}

Authentication

All platform service calls use the same CPOD_API_KEY (or OAuth token) as EDM calls. No separate credentials are required.

Platform service availability depends on your subscription tier. Skills and Workflows require the Enterprise plan. Audit, Flags, and Secrets are available on Pro and above.