Utility
Agent capabilities
Get machine-readable API documentation for agent discovery
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 atext/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
| Status | Description |
|---|---|
503 | Service 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
...
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
...