List Page Links

Retrieve all links belonging to a project ordered by position.

GET /api/v1/pages/{id}/links

cURL

curl https://okl.ink/api/v1/pages/cly1019283749/links \
  -H "Authorization: Bearer YOUR_API_TOKEN"

200 OK

[
  {
    "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
  }
]

List Page Links

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

Headers

Authorization · string · required

Bearer token with pages:read scope.

Path Parameters

id · string · required

The project ID.

Response

Returns an array of link tile objects:

id · string

Link ID

type · string

Link type

url · string

Destination URL

position · number

Position index

title · string | null

Title

size · string

Tile span size

thumbnail · string | null

Thumbnail URL

active · boolean

Active status

highlighted · boolean

Highlight state

clicks · number

Outbound click count

cURL

curl https://okl.ink/api/v1/pages/cly1019283749/links \
  -H "Authorization: Bearer YOUR_API_TOKEN"

200 OK

[
  {
    "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
  }
]