API ReferenceGolinks

Update

Re-point it, rename it, or put it away.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

linkIdstringRequired

Request

This endpoint expects an object.
slugstringOptional
urlstringOptional
descriptionstringOptional
editorUserIdslist of stringsOptional
archivedbooleanOptional

Response

This endpoint returns an object.
idstring
organizationIdstring
slugstring

The bit after go/. Normalised hard on the way in: lowercase, with spaces and underscores folded to hyphens, because the whole value of go/roadmap is that a colleague can guess it.

urlstring
clicksinteger
Every follow since the link was made.
editorUserIdslist of strings

Who may change it, when it is not simply anybody with a seat. Empty means no restriction, which is what every link is until somebody narrows it. Never affects who may follow a link.

archivedboolean
Out of the list, still working. Archiving is about the list, not about breaking a URL somebody has in a document somewhere.
createdAtdatetime
updatedAtdatetime
descriptionstringOptional
lastUsedAtdatetimeOptional
createdByobjectOptional
A person in a Taktoria organization.
archivedAtdatetimeOptional

Errors

404
Not Found Error
409
Conflict Error
422
Validation Error