# Skills Endpoints {#skills-endpoints}


Manage organizational and employee skills.


## Base Path {#base-path}


```
/api/skill
```


## Endpoints {#endpoints}



### List Skills {#list-skills}


```
GET /api/skill
Authorization: Bearer {token}
```

**Response:**

```json
{
  "items": [
    { "id": "uuid", "name": "TypeScript", "color": "#3178C6" },
    { "id": "uuid", "name": "React", "color": "#61DAFB" }
  ],
  "total": 25
}
```


### Create Skill {#create-skill}


```
POST /api/skill
Authorization: Bearer {token}
```

```json
{
  "name": "GraphQL",
  "color": "#E535AB",
  "description": "GraphQL API development"
}
```


### Update Skill {#update-skill}


```
PUT /api/skill/:id
Authorization: Bearer {token}
```


### Delete Skill {#delete-skill}


```
DELETE /api/skill/:id
Authorization: Bearer {token}
```


### Assign Skill to Employee {#assign-skill-to-employee}


Skills are assigned through the employee update endpoint:

```json
PUT /api/employee/:id
{
  "skills": [{ "id": "skill-uuid-1" }, { "id": "skill-uuid-2" }]
}
```


## Related Pages {#related-pages}


- [Skills Management](https://sourcey-gauzy.pages.dev/features/skills-management/index.md) — feature guide
- [Employee Endpoints](https://sourcey-gauzy.pages.dev/api/employee-endpoints/index.md) — employee API