Skip to main content
GET
/
skills
/
manage
List skills or get a single skill
curl --request GET \
  --url https://asteragents.com/api/skills/manage \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "skills": [
    {
      "id": 1,
      "name": "PDF Report Generator",
      "description": "Generate formatted PDF reports from structured data",
      "metadata": null,
      "fileCount": 3,
      "createdAt": "2026-03-10T10:00:00.000Z",
      "updatedAt": "2026-03-10T10:00:00.000Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

​
id
integer

Optional skill ID to retrieve a single skill with full details

Response

Successfully retrieved skills

​
success
boolean
required
​
skills
object[]

Returned when listing all skills (no id param)

​
skill
object

Returned when fetching a single skill (with id param)