List Endpoints

GET /v1/skills/:integration

Returns all available endpoints for a specific integration, organized by category (e.g., issues, pull-requests, repositories).

Authentication

Required. Bearer token: Authorization: Bearer sk_xxx

Path parameters

Parameter	Type	Required	Description
integration	string	Yes	Integration slug (e.g., github, gmail)

Response

{
  "integration": "github",
  "status": "connected",
  "categories": [
    {
      "name": "issues",
      "endpoints": [
        { "name": "create_issue", "method": "POST" },
        { "name": "list_issues_for_repo", "method": "GET" },
        { "name": "get_issue", "method": "GET" },
        { "name": "update_issue", "method": "PATCH" },
        { "name": "list_comments", "method": "GET" },
        { "name": "create_comment", "method": "POST" },
        { "name": "list_labels_on_issue", "method": "GET" },
        { "name": "add_labels", "method": "POST" }
      ]
    },
    {
      "name": "pull-requests",
      "endpoints": [
        { "name": "create_pull", "method": "POST" },
        { "name": "list_pull", "method": "GET" },
        { "name": "get_pull", "method": "GET" },
        { "name": "merge_pull", "method": "PUT" }
      ]
    }
  ]
}

Response fields

Field	Type	Description
integration	string	Integration slug
status	string	Connection status for this user
categories[].name	string	Category name (maps to endpoint folder)
categories[].endpoints[].name	string	Endpoint action name
categories[].endpoints[].method	string	HTTP method (GET, POST, PATCH, PUT, DELETE)

Errors

Code	Error	Description
401	unauthorized	Missing or invalid API key
403	scope_not_allowed	API key doesn’t have access to this integration
404	not_found	Integration not found

Example

$ curl -H "Authorization: Bearer sk_a1b2c3d4..." \
    https://api.skillett.dev/v1/skills/github