rizamodocs
Links

Update a short link

PATCH
/links/{id}

A new url applies to every click from now on, wherever the link was shared; it can take a minute to reach every place, at most 11 minutes in one under heavy load. expiresAt null makes it never expire. A new url needs the team to have a connected account or a paid plan, as making a link does.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the web app, under Developers. It starts with rz_live_.

Path Parameters

id*string

The short link's id (lnk_).

Lengthlength <= 100

Request Body

application/json
  1. body
url?string

Where the link sends people: a public http or https address, up to 2,048 characters, without line breaks. It is kept as the URL standard writes it (url in the answer: the host in ASCII, the path encoded). Rizamo's own short links are refused, so a link never points at another.

Match^[^\u0000-\u001f\u007f-\u009f]*$
Lengthlength <= 2048
expiresAt?|

When it stops working, in the future. Null: it never expires.

Response Body

OK

application/json
  1. response
id*string
code*string
shortUrl*string

The link to share. It sends people on to url and counts the click.

url*string

Where it sends people.

profileId*|

The profile it belongs to. Null: it is its creator's (the person, key or agent that made it).

source*|null
createdBy*||||

Null when Rizamo made it on its own, such as for a comment automation.

clicks*integer

Clicks so far. Link previews and bots are not counted; one person clicking twice counts twice.

Range-9007199254740991 <= value <= 9007199254740991
expiresAt*|

From then on the link answers 404. Null: it never expires.

disabledAt*|

When Rizamo disabled it for breaking the Acceptable Use Policy: it answers 404 from then on, whatever changes. Null for every other link.

createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
Example Request
curl -X PATCH 'https://api.rizamo.com/v1/links/lnk_01m4b3r6g0e48txnypr2tcytdp' \  -H 'Content-Type: application/json' \  -d '{  "expiresAt": "2026-12-31T23:59:59Z"}'
Example Response
{  "id": "lnk_01m4b3r6g0e48txnypr2tcytdp",  "code": "k7Qm2p",  "shortUrl": "https://go.rizamo.com/k7Qm2p",  "url": "https://cafelumen.pt/menu?utm_source=instagram&utm_medium=social&utm_campaign=winter-menu",  "profileId": "prof_01m40k9k80fxd8cvng8derm7g9",  "source": null,  "createdBy": {    "type": "agent",    "agent": "claudecode",    "name": "Claude Code",    "agentId": "agac_01m4rmaz80fs9a5amx5zbezkq2",    "onBehalfOf": {      "userId": "user_01m4pc7v40fdm89vjt5k51b5h8",      "name": "Ana Costa"    }  },  "clicks": 214,  "expiresAt": "2026-12-31T23:59:59.000Z",  "disabledAt": null,  "createdAt": "2026-11-04T10:12:31.000Z",  "updatedAt": "2026-11-08T12:00:00.000Z"}