Get Dataset Skill - Cognee Documentation

GET

/

api

/

v1

/

skills

/

{skill_id}

Get Dataset Skill

curl --request GET \
  --url https://{tenant}.aws.cognee.ai/api/v1/skills/{skill_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "name": "<string>",
  "description": "",
  "maintainer": "",
  "maintainer_url": "",
  "version": "",
  "tags": [
    "<string>"
  ],
  "license": "",
  "declared_tools": [
    "<string>"
  ],
  "dataset_scope": [
    "<string>"
  ],
  "is_active": true,
  "source_repo_url": "",
  "source_dir": "",
  "procedure": ""
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

skill_id

string

required

Query Parameters

dataset_id

string<uuid>

required

Dataset UUID the skill belongs to.

Response

Successful Response

A single skill including its full procedure body.

id

string

required

Stable skill identifier.

name

string

required

Skill name.

description

string

default:""

Short summary for routing.

maintainer

string

default:""

Publishing company / team that maintains the skill.

maintainer_url

string

default:""

Maintainer homepage or repo URL.

version

string

default:""

Skill version string.

tags

string[]

Free-form category tags.

license

string

default:""

License identifier.

declared_tools

string[]

Tools the skill is allowed to use.

dataset_scope

string[]

Dataset UUIDs this skill is scoped to.

is_active

boolean

default:true

Whether the skill is active for routing.

source_repo_url

string

default:""

Source repository URL, when known.

source_dir

string

default:""

On-disk source directory.

procedure

string

default:""

The full skill instruction body.

⌘I

Get Dataset Skill

curl --request GET \
  --url https://{tenant}.aws.cognee.ai/api/v1/skills/{skill_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "name": "<string>",
  "description": "",
  "maintainer": "",
  "maintainer_url": "",
  "version": "",
  "tags": [
    "<string>"
  ],
  "license": "",
  "declared_tools": [
    "<string>"
  ],
  "dataset_scope": [
    "<string>"
  ],
  "is_active": true,
  "source_repo_url": "",
  "source_dir": "",
  "procedure": ""
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}