v68

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0189430445.4 KB
Shortcuts

Update shortcut

Updates the shortcut with the given ID.

post/rest/api/v1/updateshortcut

Query parameters

localestring

The client's preferred locale in rfc5646 format (e.g. en, ja, pt-BR). If omitted, the Accept-Language will be used. If not present or not supported, defaults to the closest match or en.

Request body

idinteger required

The opaque id of the user generated content.

inputAliasstring

Link text following go/ prefix as entered by the user.

destinationUrlstring

Destination URL for the shortcut.

destinationDocumentIdstring

Glean Document ID for the URL, if known.

descriptionstring

A short, plain text blurb to help people understand the intent of the shortcut.

unlistedboolean

Whether this shortcut is unlisted or not. Unlisted shortcuts are visible to author + admins only.

urlTemplatestring

For variable shortcuts, contains the URL template; note, destinationUrl contains default URL.

Example request

{
  "addedRoles": [
    {
      "person": {
        "name": "George Clooney",
        "obfuscatedId": "abc123"
      }
    }
  ],
  "removedRoles": [
    {
      "person": {
        "name": "George Clooney",
        "obfuscatedId": "abc123"
      }
    }
  ]
}

Response

OK