Skip to main content

skillAuthoringService

Workspace API


Workspace API / services/skillAuthoringService

services/skillAuthoringService

Functions

createSkill()

createSkill(organizationId, userId, data): Promise<Skill>

Defined in: services/skillAuthoringService.ts:107

Create a new skill

Parameters

organizationId

string

userId

string

data

CreateSkillRequest

Returns

Promise<Skill>


createSkillVersion()

createSkillVersion(skillId, organizationId, userId, data): Promise<SkillVersion>

Defined in: services/skillAuthoringService.ts:190

Create a new skill version (draft)

Parameters

skillId

string

organizationId

string

userId

string

data

CreateSkillVersionRequest

Returns

Promise<SkillVersion>


ensureDraftSkillVersionSeeded()

ensureDraftSkillVersionSeeded(params): Promise<SkillVersion | null>

Defined in: services/skillAuthoringService.ts:380

Ensure a draft skill version is seeded with the current "snapshot" from the active version.

This is an idempotent safety net for drafts created before snapshot seeding existed. It fills only missing/empty fields and records a _coda.seeded_from_version_id marker to prevent re-seeding (so user-cleared fields stay cleared).

Parameters

params
organizationId

string

userId

string

versionId

string

Returns

Promise<SkillVersion | null>


updateSkillVersion()

updateSkillVersion(versionId, organizationId, userId, data): Promise<SkillVersion>

Defined in: services/skillAuthoringService.ts:561

Update a draft skill version

Parameters

versionId

string

organizationId

string

userId

string

data

Partial<CreateSkillVersionRequest>

Returns

Promise<SkillVersion>


publishSkillVersion()

publishSkillVersion(versionId, organizationId, userId): Promise<SkillVersion>

Defined in: services/skillAuthoringService.ts:721

Publish a draft skill version

Parameters

versionId

string

organizationId

string

userId

string

Returns

Promise<SkillVersion>


deprecateSkillVersion()

deprecateSkillVersion(versionId, organizationId, userId): Promise<void>

Defined in: services/skillAuthoringService.ts:885

Deprecate a skill version

Parameters

versionId

string

organizationId

string

userId

string

Returns

Promise<void>


deleteSkill()

deleteSkill(skillId, organizationId, userId): Promise<void>

Defined in: services/skillAuthoringService.ts:939

Delete a skill (soft delete) Sets deleted_at timestamp and is_active = false Does NOT delete associated data (versions, workflow runs, audit logs) for audit purposes

Parameters

skillId

string

organizationId

string

userId

string

Returns

Promise<void>


validateSkillVersion()

validateSkillVersion(versionId, organizationId, userId, testInput): Promise<{ valid: boolean; inputErrors?: string[]; warnings?: string[]; }>

Defined in: services/skillAuthoringService.ts:1021

Validate skill version in dry-run mode

Parameters

versionId

string

organizationId

string

userId

string

testInput

Record<string, unknown>

Returns

Promise<{ valid: boolean; inputErrors?: string[]; warnings?: string[]; }>