> ## 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.

# List Page Links

> Retrieve all links belonging to a project ordered by position.

# List Page Links

Returns all links associated with a page, including their click counts and grid positions. Requires `pages:read` scope.

### Headers

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

### Path Parameters

<ParamField path="id" type="string" required>
  The project ID.
</ParamField>

### Response

Returns an array of link tile objects:

<ResponseField name="id" type="string">Link ID</ResponseField>
<ResponseField name="type" type="string">Link type</ResponseField>
<ResponseField name="url" type="string">Destination URL</ResponseField>
<ResponseField name="position" type="number">Position index</ResponseField>
<ResponseField name="title" type="string | null">Title</ResponseField>
<ResponseField name="size" type="string">Tile span size</ResponseField>
<ResponseField name="thumbnail" type="string | null">Thumbnail URL</ResponseField>
<ResponseField name="active" type="boolean">Active status</ResponseField>
<ResponseField name="highlighted" type="boolean">Highlight state</ResponseField>
<ResponseField name="clicks" type="number">Outbound click count</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://okl.ink/api/v1/pages/cly1019283749/links \
    -H "Authorization: Bearer YOUR_API_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": "cmsh_link_99",
      "type": "github",
      "url": "https://github.com/hebuildapps/demo-links",
      "position": 0,
      "title": "okl.ink Source Code",
      "size": "2x1",
      "thumbnail": null,
      "active": true,
      "highlighted": false,
      "clicks": 142
    }
  ]
  ```
</ResponseExample>