Table of Contents

Class SkillsController

Namespace
Builvero.Api.Controllers
Assembly
Builvero.Api.dll

Provides API endpoints for retrieving skills, optionally filtered by category.

[ApiController]
[Route("api/skills")]
[Authorize]
public class SkillsController : ControllerBase
Inheritance
SkillsController
Inherited Members

Remarks

All endpoints require authentication (JWT token). Skills are used to match users with projects based on technical expertise. Only active skills are returned.

Constructors

SkillsController(ISkillService)

Initializes a new instance of the SkillsController class.

public SkillsController(ISkillService skillService)

Parameters

skillService ISkillService

Service for skill operations.

Methods

GetSkills(string?, CancellationToken)

Retrieves all active skills, optionally filtered by category.

[HttpGet]
public Task<ActionResult<List<SkillDto>>> GetSkills(string? category, CancellationToken cancellationToken)

Parameters

category string

Optional category filter (e.g., "SoftwareEngineering", "Design"). Must match a SkillCategory enum value (case-insensitive).

cancellationToken CancellationToken

Cancellation token to cancel the operation.

Returns

Task<ActionResult<List<SkillDto>>>

200 OK: Returns list of SkillDto objects

400 Bad Request: Error retrieving skills

Remarks

Requires authentication. If category is provided and valid, only skills in that category are returned. If category is null, empty, or invalid, all active skills are returned regardless of category.

Edit this page