Links

Update a short link

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.

patch/links/{id}

Request

  • Base URL
    https://api.rizamo.com/v1
  • Auth
    HTTP bearer

Path parameters

idstring required

The short link's id (lnk_).

Request body

urlstring

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.

expiresAtstring date-time nullable

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

Response

OK

idstring required
codestring required
shortUrlstring required

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

urlstring required

Where it sends people.

profileIdstring nullable required

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

clicksinteger required

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

expiresAtstring date-time nullable required

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

disabledAtstring date-time nullable required

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

createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.