Inkforge Developer Platform

API Documentation

Complete reference for ClawVault, Contact Form, and Blog endpoints. Built as a standalone deployment-ready page for docs.inkforge.dev.

ClawVault API

GET /api/skills

Retrieve all available skills with metadata, tags, verification status, and review aggregate.

Request Example

GET /api/skills HTTP/1.1
Host: api.inkforge.dev
Accept: application/json

Response Example

{
  "success": true,
  "count": 2,
  "skills": [
    {
      "slug": "react-performance",
      "title": "React Performance Optimization",
      "description": "Audit and optimize React apps for Core Web Vitals.",
      "tags": ["react", "performance", "frontend"],
      "verified": true,
      "reviews": {
        "avgRating": 4.9,
        "count": 31
      }
    },
    {
      "slug": "api-security",
      "title": "API Security Hardening",
      "description": "Threat modeling and OWASP remediation for production APIs.",
      "tags": ["security", "backend"],
      "verified": false,
      "reviews": {
        "avgRating": 4.7,
        "count": 12
      }
    }
  ]
}

GET /api/skills/{slug}

Return detailed data for one skill, identified by its unique slug.

Request Example

GET /api/skills/react-performance HTTP/1.1
Host: api.inkforge.dev
Accept: application/json

Response Example

{
  "success": true,
  "skill": {
    "slug": "react-performance",
    "title": "React Performance Optimization",
    "description": "Audit and optimize React apps for Core Web Vitals.",
    "longDescription": "Performance diagnostics, bundle splitting, and render optimization.",
    "verified": true,
    "createdAt": "2026-01-14T18:20:00Z",
    "updatedAt": "2026-02-02T09:11:00Z",
    "owner": {
      "name": "Inkforge Team",
      "id": "team_01"
    }
  }
}

GET /api/skills/{slug}/reviews

List public reviews for a skill including rating, author, and optional comment body.

Request Example

GET /api/skills/react-performance/reviews HTTP/1.1
Host: api.inkforge.dev
Accept: application/json

Response Example

{
  "success": true,
  "skill": "react-performance",
  "count": 2,
  "reviews": [
    {
      "id": "rev_7f99",
      "rating": 5,
      "author": "A. Patel",
      "comment": "Huge improvement in TTI and Lighthouse score.",
      "createdAt": "2026-02-05T13:20:22Z"
    },
    {
      "id": "rev_7f9a",
      "rating": 4,
      "author": "R. Chen",
      "comment": "Great recommendations; implementation was straightforward.",
      "createdAt": "2026-02-06T16:08:15Z"
    }
  ]
}

POST /api/skills

Create a new skill entry. Requires JSON body with title, slug, and content metadata.

Request Example

POST /api/skills HTTP/1.1
Host: api.inkforge.dev
Content-Type: application/json
Authorization: Bearer <token>

{
  "title": "Node.js Observability",
  "slug": "nodejs-observability",
  "description": "Tracing, logs, and metrics setup for Node services.",
  "tags": ["node", "monitoring", "devops"]
}

Response Example

{
  "success": true,
  "message": "Skill created successfully.",
  "skill": {
    "slug": "nodejs-observability",
    "title": "Node.js Observability",
    "verified": false,
    "createdAt": "2026-02-07T13:19:42Z"
  }
}

POST /api/skills/{slug}/verify

Submit or perform verification of an existing skill. Used by moderation and trust workflows.

Request Example

POST /api/skills/nodejs-observability/verify HTTP/1.1
Host: api.inkforge.dev
Content-Type: application/json
Authorization: Bearer <token>

{
  "verificationType": "manual_review",
  "notes": "Validated examples and references.",
  "reviewerId": "admin_44"
}

Response Example

{
  "success": true,
  "message": "Skill verified.",
  "skill": {
    "slug": "nodejs-observability",
    "verified": true,
    "verifiedAt": "2026-02-07T13:24:10Z",
    "verifiedBy": "admin_44"
  }
}

Contact Form API

POST /api/contact

Submit a contact request from the public website with name, email, subject, and message payload.

Request Example

POST /api/contact HTTP/1.1
Host: api.inkforge.dev
Content-Type: application/json

{
  "name": "Jordan Blake",
  "email": "jordan@example.com",
  "subject": "Enterprise pricing",
  "message": "Can you share details for annual plans?"
}

Response Example

{
  "success": true,
  "message": "Contact request received.",
  "ticketId": "ct_90213",
  "receivedAt": "2026-02-07T13:28:52Z"
}

Blog API

GET /blog

Fetch all published blog posts with title, slug, excerpt, and publication metadata.

Request Example

GET /blog HTTP/1.1
Host: api.inkforge.dev
Accept: application/json

Response Example

{
  "success": true,
  "count": 2,
  "posts": [
    {
      "slug": "inside-clawvault",
      "title": "Inside ClawVault",
      "excerpt": "How we structured reusable skill packages.",
      "publishedAt": "2026-01-27",
      "author": "Inkforge Editorial"
    },
    {
      "slug": "deploying-on-edge",
      "title": "Deploying on the Edge",
      "excerpt": "Reducing latency with globally distributed runtimes.",
      "publishedAt": "2026-02-03",
      "author": "Inkforge Editorial"
    }
  ]
}

GET /blog/{slug}

Return one blog post body and metadata by post slug.

Request Example

GET /blog/inside-clawvault HTTP/1.1
Host: api.inkforge.dev
Accept: application/json

Response Example

{
  "success": true,
  "post": {
    "slug": "inside-clawvault",
    "title": "Inside ClawVault",
    "content": "# Inside ClawVault\\n\\nClawVault is designed to make skills portable...",
    "tags": ["engineering", "product"],
    "author": "Inkforge Editorial",
    "publishedAt": "2026-01-27",
    "updatedAt": "2026-02-01"
  }
}