API Documentation

Integrate SkillFlow skills directly into your applications. Simple REST API, powerful results.

Authentication
Bearer token in Authorization header
Base URL
https://api.skillflow.ai/v1
Rate Limit
100 requests/minute per API key

Getting Started

1

Create an account

Sign up at SkillFlow and navigate to your dashboard.

2

Generate an API key

Go to Dashboard → API Keys and create a new key.

3

Make your first request

Use the examples below to execute a skill via the API.

Execute a Skill

curl
curl -X POST https://api.skillflow.ai/v1/skills/execute \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "skillId": 1,
    "input": "Analyze this lead: John Smith, VP of Sales at Acme Corp, 500 employees, SaaS industry"
  }'

Available Endpoints

GET
/v1/skills

List all approved skills with optional filters

Params: category?, search?, featured?, page?, limit?

GET
/v1/skills/:slug

Get full skill details including reviews and metrics

Params: slug (required)

POST
/v1/skills/execute

Execute a skill with input text and get AI-generated output

Params: skillId, input (required)

GET
/v1/categories

List all skill categories with counts

Params: none

GET
/v1/stats

Get platform-wide statistics and metrics

Params: none

Response Format

json
{
  "output": "The AI-generated response text...",
  "durationMs": 3200,
  "success": true
}

Error Handling

StatusCodeDescription
200OKSkill executed successfully
400Bad RequestInvalid input or missing required fields
401UnauthorizedMissing or invalid API key
404Not FoundSkill not found
429Rate LimitedToo many requests — wait and retry
500Server ErrorInternal error — contact support