AIair
Showcases

/showcases/:showcaseId/share-links/:shareLinkId

Changed on

Change the settings of a showcase's share link.

Works like PATCH /v1/boards/{boardId}/share-links/{shareLinkId}. Only the settings you send change. Everything else on the link, including its password, stays as it is. Send password: null or expiresAt: null to remove them.

Returns an empty body on success. Use GET /v1/showcases/{showcaseId} to read the link's settings.

Requires the share_links.write and showcases.read OAuth scopes.

patch/v1/showcases/{showcaseId}/share-links/{shareLinkId}

Request

Request body

activeboolean

Whether the link works. A disabled link keeps its settings and can be enabled again.

allowDownloadboolean

Whether visitors can download the original files

passwordstring nullable

Password visitors must enter to open the link. null removes it. Never returned; read hasPassword instead.

expiresAtstring date-time nullable

When the link stops working. Must be in the future. null removes the expiration.

requireAccountboolean

Whether visitors must sign in to Air to open the link

comments'hidden' | 'read_only' | 'allowed'

What visitors can do with comments. allowed lets them add comments, which writes to your workspace.

customFields'hidden' | 'read_only' | 'editable'

What visitors can do with custom field values. editable lets them change values, which writes to your workspace.

Response

Share link updated successfully

Changes