API ReferenceGolinks

Create

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
slugstringRequired
urlstringRequired

A bare acme.com/thing is assumed to be https. Anything that is not http(s) is refused: a javascript: destination on a link the whole company is told to click is stored XSS.

descriptionstringOptional
editorUserIdslist of stringsOptional

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

402
Subscription Required Error
409
Conflict Error
422
Validation Error