API Reference

REST API for SkillPort Market

Base URL:

https://api.skillport.market

Authentication

Pass your Supabase access token in the Authorization header:

Authorization: Bearer <access_token>

Skills

GET/v1/skills

List and search skills. Supports query, category, sort, page, and limit params.

GET/v1/skills/:id

Get skill details including manifest, permissions, and danger flags.

POST/v1/skills

Upload a new .ssp package. Requires auth. Accepts multipart/form-data with file, price, category, and tags.

GET/v1/skills/:id/download

Get a signed download URL for the .ssp file. Checks purchase entitlement for paid skills.

Reviews

GET/v1/skills/:id/reviews

List reviews for a skill.

POST/v1/skills/:id/reviews

Post a review (1-5 rating + optional comment). Requires auth.

Purchases

POST/v1/purchases

Initiate a purchase via Stripe Checkout. Returns a checkout session URL.

GET/v1/purchases/:skill_id

Check purchase entitlement for a skill.

Signing Keys

POST/v1/keys

Register a public signing key. Requires auth.

User

GET/v1/me/skills

List your published skills. Requires auth.

GET/v1/me/purchases

List your purchased skills. Requires auth.

POST/v1/me/stripe-connect

Create a Stripe Connect onboarding link. Requires auth.

GET/v1/me/stripe-status

Check your Stripe Connect account status. Requires auth.

GET/v1/profiles/:username

Get a public user profile with published skills.