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
| Service | SDK namespace | What it does |
|---|---|---|
| Skills | sdk.skills | Run pre-built or custom analytical functions against EDM data |
| Workflows | sdk.workflows | Define and trigger multi-step orchestration sequences |
| Jobs | sdk.jobs | Submit async work units, monitor progress, retrieve output |
| Data Masking | sdk.masking | Mask PII and sensitive values for safe downstream use |
| Telemetry | sdk.telemetry | Audit trail, LLM traces, and app analytics — all auto-instrumented |
| Feature Flags | sdk.flags | Evaluate feature flags with per-tenant and per-user context |
| Secrets | sdk.secrets | Resolve 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 payloadConsistent 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.