Trigger skill resolution

POST

/api/v1/skills/{id}(*)/resolve

• Current server

Parameters

Query Parameters

projectId

required

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

string

>= 1 characters

Example

00000000-0000-0000-0000-000000000000

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

Responses

201

Success

Media type application/json

object

_id

required

string

ref

required

string

source

required

string

skillName

required

string

skillPath

required

string

commitHash

required

string

commitTimestamp

required

string | null format: date-time

name

required

string

description

required

string

license

string

compatibility

string

allowedTools

string

metadata

object

key

additional properties

string

content

required

string

archiveUrl

required

string

validationWarnings

Array<string>

resolvedAt

required

string | null format: date-time

createdAt

required

string | null format: date-time

projectId

required

string

Example ^generated

{
  "_id": "example",
  "ref": "example",
  "source": "example",
  "skillName": "example",
  "skillPath": "example",
  "commitHash": "example",
  "commitTimestamp": "2026-04-15T12:00:00Z",
  "name": "example",
  "description": "example",
  "license": "example",
  "compatibility": "example",
  "allowedTools": "example",
  "metadata": {
    "additionalProperty": "example"
  },
  "content": "example",
  "archiveUrl": "example",
  "validationWarnings": [
    "example"
  ],
  "resolvedAt": "2026-04-15T12:00:00Z",
  "createdAt": "2026-04-15T12:00:00Z",
  "projectId": "example"
}

404

Skill not found

500

Blob storage error