Skip to content
Scope

Get skill revision by ref

GET
/api/v1/skill-revisions/by-ref/{ref}(*)

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “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

Section titled “ Responses ”

200

Section titled “200 ”

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

Section titled “404 ”

Skill revision not found