---
title: "Link Skill To Folder"
method: POST
path: "/api/skills/{skill_id}/link"
tags: ["skills"]
---

# Link Skill To Folder

`POST /api/skills/{skill_id}/link`

## Request

- Base URL: `https://app.ctlsurf.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ctlsurf.com/api/skills/{skill_id}/link`
- Auth: HTTP bearer

Link a skill to an additional project folder.

This makes the skill available in the target folder without moving it.
The skill can be linked to multiple folders.

Only the skill owner can link their skills to projects they own.

## Path parameters

- `skill_id` string, uuid, required

## Request body

- SkillLinkRequest: Request to link a skill to a project.
  - `folder_id` string, uuid, required

## Response `201`

Successful Response

- SkillLinkResponse: Response for skill link operation.
  - `skill_id` string, uuid, required
  - `folder_id` string, uuid, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ctlsurf/apis/notebook-control-plane.md) · [All operations](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/revisions/ddfbbe20d5ce?raw)