@@ -144,6 +144,7 @@ case "$group" in
     export INTERNAL_API_SECRET=scim-http-ci-local-secret-at-least-32-characters
     export DB_TX_TRIPWIRE=throw
     export NEXT_PUBLIC_CHAT_DISABLED=true
+    export SIM_LINKS=true
     start_app scim 3017 SCIM record-http-status
     SCIM_E2E_BASE_URL="$local_app_url" \
     SCIM_E2E_DATABASE_URL="$DATABASE_URL" \
@@ -155,6 +156,11 @@ case "$group" in
     VERSION_COMPARE_E2E_AUTH_SECRET="$BETTER_AUTH_SECRET" \
     VERSION_COMPARE_E2E_REPORT_PATH="$report_dir/version-compare-http-report.json" \
       bun run test:workflow-version-compare:e2e
+    SIM_LINKS_E2E_BASE_URL="$local_app_url" \
+    SIM_LINKS_E2E_DATABASE_URL="$DATABASE_URL" \
+    SIM_LINKS_E2E_AUTH_SECRET="$BETTER_AUTH_SECRET" \
+    SIM_LINKS_E2E_REPORT_PATH="$report_dir/sim-links-e2e-report.json" \
+      bun run test:sim-links:e2e
     ;;
 
   # The search suites serve their own fixtures in-process and need no app. They share this group
 
@@ -101,6 +101,7 @@ Events use identifiers such as `resource.action`. These categories are represent
 | API keys | `api_key.created`, `api_key.revoked` |
 | Credentials | `credential.created`, `credential.deleted`, `oauth.disconnected` |
 | Organization | `organization.updated`, `org_member.added`, `org_member.role_changed`, `organization.sso_provider.updated` |
+| Sim links | `sim_link.created`, `sim_link.updated`, `sim_link.deleted` |
 | Exports and drains | `audit_logs.exported`, `data_drain.created`, `data_drain.updated`, `data_drain.ran`, `data_drain.tested` |
 
 Authentication failures and password-reset requests use an anonymous actor and record the target account separately. Impersonation and administrative session revocations identify the operator and target organization. Table-row mutations record summaries and counts without copying row contents.
 
@@ -5,6 +5,7 @@
     "quickstart",
     "find-content",
     "ask-questions",
+    "sim-links",
     "troubleshooting",
     "---Connect sources---",
     "connect-your-account",
 
@@ -0,0 +1,53 @@
+---
+title: Sim Links
+description: Short sim/ links that take everyone in your organization to the right page
+---
+
+Sim Links are short, memorable names for the pages your team opens often, like `sim/handbook` for the employee handbook or `sim/okta` for your sign-in portal. Anyone in the organization can open them, with or without a Search seat. They work like go links in other tools.
+
+Open **Sim Links** in the organization sidebar to see every link in your organization. Search by name, destination, or description.
+
+## Open a link
+
+Go to `https://sim.ai/sim/<name>`, for example `https://sim.ai/sim/handbook`. On a self-hosted deployment, use your Sim address instead of `sim.ai`. Sim sends you to the link's destination. If you aren't signed in, Sim asks you to sign in first, then continues to the link.
+
+Names ignore case and punctuation, so `sim/Team-Handbook`, `sim/team_handbook`, and `sim/teamhandbook` all open the same link. The destination still applies its own permissions.
+
+If nobody has created the link yet, Sim offers to create it with that name.
+
+## Create a link
+
+1. Open **Sim Links** and select **New link**.
+2. Enter the **Destination URL**, a full `https://` address.
+3. Enter a **Name**. Use letters, numbers, and `. : @ & ~ - _`.
+4. Optionally add a **Description** so teammates know what the link is for.
+5. Select **Create**.
+
+Select **Copy link** from a link's menu to share it.
+
+## Add values to a link
+
+Anything after the name is added to the destination. If `sim/docs` opens `https://docs.example.com`, then `sim/docs/billing/invoices` opens `https://docs.example.com/billing/invoices`.
+
+To place a value somewhere else, put `{*}` in the destination URL:
+
+| Destination URL | You open | Sim opens |
+| --- | --- | --- |
+| `https://jira.example.com/browse/PROD-{*}` | `sim/jira/123` | `https://jira.example.com/browse/PROD-123` |
+| `https://wiki.example.com/search?q={*}` | `sim/wiki/expense policy` | `https://wiki.example.com/search?q=expense%20policy` |
+| `https://github.com/acme/{*}/issues/{*}` | `sim/issues/api/42` | `https://github.com/acme/api/issues/42` |
+
+Each value fills the next `{*}` in order, and the last `{*}` takes everything that remains. A link with `{*}` can also have a **Default destination**, which opens when you use the link without a value. `{*}` can't replace the domain.
+
+## Control access
+
+Under **Access**, the creator of a link can choose:
+
+- **Unlist**: hides the link from the Sim Links page for everyone except the creator and organization admins. Anyone who knows the name can still open it.
+- **Restrict editing**: only the creator and organization admins can edit or delete the link. Everyone can still open it.
+
+Without restrictions, any member can edit or delete a link. Only the creator and organization admins can change its access settings. Creating, editing, and deleting links is recorded in your organization's [audit logs](/platform/enterprise/audit-logs).
+
+## Related docs
+
+- [Find content](/search/find-content)
@@ -10,6 +10,7 @@ import {
   ChipModalFooter,
   ChipModalHeader,
 } from '@sim/emcn'
+import { isApiClientError } from '@/lib/api/client/errors'
 import type { SimLink, SimLinkBody } from '@/lib/api/contracts/sim-links'
 import {
   isVariableSimLinkUrl,
@@ -45,6 +46,7 @@ function draftOf(link: SimLink | undefined, initialName = ''): SimLinkBody {
 /** Mount per link (keyed) so each open starts from that link's saved fields. */
 export function SimLinkModal({ organizationId, onClose, link, initialName }: SimLinkModalProps) {
   const mutation = useSaveSimLink(organizationId)
+  const nameTaken = isApiClientError(mutation.error) && mutation.error.status === 409
   const [draft, setDraft] = useState(() => draftOf(link, initialName))
   const [errors, setErrors] = useState<Partial<Record<Field, string>>>({})
   const variable = isVariableSimLinkUrl(draft.url)
@@ -55,6 +57,7 @@ export function SimLinkModal({ organizationId, onClose, link, initialName }: Sim
   const change = <K extends keyof SimLinkBody>(field: K, value: SimLinkBody[K]) => {
     setDraft((current) => ({ ...current, [field]: value }))
     setErrors((current) => ({ ...current, [field]: undefined }))
+    if (mutation.isError) mutation.reset()
   }
 
   const save = () => {
@@ -119,7 +122,7 @@ export function SimLinkModal({ organizationId, onClose, link, initialName }: Sim
           maxLength={SIM_LINK_NAME_MAX_LENGTH}
           value={draft.name}
           onChange={(value) => change('name', value)}
-          error={errors.name}
+          error={errors.name ?? (nameTaken ? mutation.error?.message : undefined)}
           hint='Letters, numbers, and . : @ & ~ - _. Case and punctuation are ignored, so sim/Q4-goals is sim/q4goals.'
         />
         <ChipModalField
@@ -165,7 +168,7 @@ export function SimLinkModal({ organizationId, onClose, link, initialName }: Sim
             </label>
           </div>
         </ChipModalField>
-        <ChipModalError>{mutation.error?.message}</ChipModalError>
+        <ChipModalError>{nameTaken ? undefined : mutation.error?.message}</ChipModalError>
       </ChipModalBody>
       <ChipModalFooter
         onCancel={onClose}
 
@@ -65,7 +65,7 @@ export function SimLinks({ organizationId }: SimLinksProps) {
   return (
     <OrganizationPage
       title='Sim Links'
-      description='Short links for your organization. Open sim/name in your browser to go to its destination.'
+      description='Short, shareable links that take your organization straight to the right page.'
       searchMode='expanded'
       searchPlaceholder='Search Sim links'
       action={
 
@@ -23,6 +23,7 @@
     "start": "next start",
     "test": "vitest run",
     "test:scim:e2e": "bun run scripts/test-scim-e2e.ts",
+    "test:sim-links:e2e": "bun run scripts/test-sim-links-e2e.ts",
     "test:browser-extension:e2e": "bun --no-env-file scripts/test-browser-extension-e2e.ts",
     "test:isolated-vm-remote:e2e": "bun run scripts/test-isolated-vm-remote-e2e.ts",
     "test:mobile:e2e": "bun --no-env-file scripts/test-mobile-e2e.ts",