Create Page

Create a new project page with metadata, optional theme, and links.

POST /api/v1/pages

cURL

curl -X POST https://okl.ink/api/v1/pages \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Project Hub",
    "description": "Essential links, repository, and live demo.",
    "slug": "my-project-hub",
    "theme": {
      "preset": "oklink",
      "density": "comfortable"
    }
  }'

201 Created

{
  "id": "cly1019283749",
  "slug": "my-project-hub",
  "title": "My Project Hub",
  "published": false
}

Create Page

Creates a new okl.ink page belonging to the token owner. Requires pages:write scope.

Headers

Authorization · string · required

Bearer token with pages:write scope.

Request Body

title · string · required

Page title.

description · string · required

One-line summary for page header and SEO metadata.

slug · string · required

Unique URL slug (e.g., my-project). Must be alphanumeric + hyphens.

coverImage · string

Optional http(s) cover banner image URL.

name · string

Optional creator display name.

theme · object

Optional theme configuration object.

Response

id · string

Created page ID.

slug · string

Assigned slug.

title · string

Page title.

published · boolean

Publication status (defaults to false).

cURL

curl -X POST https://okl.ink/api/v1/pages \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Project Hub",
    "description": "Essential links, repository, and live demo.",
    "slug": "my-project-hub",
    "theme": {
      "preset": "oklink",
      "density": "comfortable"
    }
  }'

201 Created

{
  "id": "cly1019283749",
  "slug": "my-project-hub",
  "title": "My Project Hub",
  "published": false
}