> ## Documentation Index
> Fetch the complete documentation index at: https://okl-ink.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Page

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

# Create Page

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

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token with `pages:write` scope.
</ParamField>

### Request Body

<ParamField body="title" type="string" required>
  Page title.
</ParamField>

<ParamField body="description" type="string" required>
  One-line summary for page header and SEO metadata.
</ParamField>

<ParamField body="slug" type="string" required>
  Unique URL slug (e.g., `my-project`). Must be alphanumeric + hyphens.
</ParamField>

<ParamField body="coverImage" type="string">
  Optional `http(s)` cover banner image URL.
</ParamField>

<ParamField body="name" type="string">
  Optional creator display name.
</ParamField>

<ParamField body="theme" type="object">
  Optional theme configuration object.
</ParamField>

### Response

<ResponseField name="id" type="string">
  Created page ID.
</ResponseField>

<ResponseField name="slug" type="string">
  Assigned slug.
</ResponseField>

<ResponseField name="title" type="string">
  Page title.
</ResponseField>

<ResponseField name="published" type="boolean">
  Publication status (defaults to `false`).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "id": "cly1019283749",
    "slug": "my-project-hub",
    "title": "My Project Hub",
    "published": false
  }
  ```
</ResponseExample>