Endpoint Documentation

GET /v1/skills/:integration/:endpoint

Returns complete documentation for a single endpoint, including parameters, description, usage example, and error codes. This is what agents use to understand how to call an endpoint before executing it.

Authentication

Required. Bearer token: Authorization: Bearer sk_xxx

Path parameters

Parameter	Type	Required	Description
integration	string	Yes	Integration slug (e.g., github)
endpoint	string	Yes	Endpoint action name (e.g., create_issue)

Response

{
  "name": "create_issue",
  "method": "POST",
  "category": "issues",
  "description": "Create an issue in a GitHub repository.",
  "parameters": [
    {
      "name": "repo",
      "type": "string",
      "required": true,
      "description": "Repository in owner/repo format"
    },
    {
      "name": "title",
      "type": "string",
      "required": true,
      "description": "Issue title"
    },
    {
      "name": "body",
      "type": "string",
      "required": false,
      "description": "Issue body (supports markdown)"
    },
    {
      "name": "labels",
      "type": "array",
      "required": false,
      "description": "Label names to apply"
    },
    {
      "name": "assignees",
      "type": "array",
      "required": false,
      "description": "Usernames to assign"
    }
  ],
  "example": "skillett run github create_issue --repo acme/webapp --title \"Bug report\"",
  "errors": [
    { "code": 400, "cause": "Bad Request", "fix": "Check parameter types and required fields" },
    { "code": 404, "cause": "Not Found", "fix": "Verify the repository exists and you have access" },
    { "code": 422, "cause": "Validation Failed", "fix": "Check for invalid field values" }
  ]
}

Response fields

Field	Type	Description
name	string	Endpoint action name
method	string	HTTP method
category	string	Category this endpoint belongs to
description	string	What this endpoint does
parameters[]	array	Parameter definitions
parameters[].name	string	Parameter name
parameters[].type	string	string, number, boolean, array, object
parameters[].required	boolean	Whether the parameter is required
parameters[].description	string	What this parameter does
example	string	CLI usage example
errors[]	array	Possible error responses

Errors

Code	Error	Description
401	unauthorized	Missing or invalid API key
404	not_found	Integration or endpoint not found

Example

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