Skip to main content
GET
/
skill.md
curl https://api.useknot.xyz/skill.md

# Knot API

## Quick Start

1. Authenticate via email OTP
2. Receive JWT token
3. Call action endpoints

## Endpoints

### POST /connect/start
...
Returns a markdown document describing all Knot API capabilities. Designed for AI agent consumption — agents can fetch this file at startup to discover available endpoints, authentication steps, and usage examples without any prior configuration.
This endpoint does not require authentication.

​
Response

Returns a text/markdown document containing:
  • Quick start guide
  • Authentication instructions
  • All endpoint documentation with paths and methods
  • Request and response examples
  • Error handling guidelines
Fetch /skill.md as part of your agent’s initialization routine to keep its knowledge of the Knot API current without hardcoding endpoint details.

​
Errors

StatusDescription
503Service unavailable
curl https://api.useknot.xyz/skill.md

# Knot API

## Quick Start

1. Authenticate via email OTP
2. Receive JWT token
3. Call action endpoints

## Endpoints

### POST /connect/start
...