> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synti.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Links

> Open Synti and trigger actions from browsers, scripts, launchers, and other apps using the synti:// URL scheme.

Synti registers the `synti://` URL scheme, so any app that can open a link can drive Synti. Click a `synti://` link in a browser, run one from a shell script, add it to a launcher, or embed it in your notes — Synti comes to the front and performs the action. Deep links are the glue between Synti and the rest of your workflow.

## Anatomy of a link

A deep link names an action or a route, followed by optional parameters:

```text theme={null}
synti://action/new-chat?input=Hello%20world&send=true
```

Remember to URL-encode parameter values — spaces become `%20`, and so on.

## Starting a chat

The most common link opens a new session.

```text theme={null}
synti://action/new-chat
```

It accepts these parameters:

| Parameter | Purpose                                                              |
| --------- | -------------------------------------------------------------------- |
| `input`   | Text to pre-fill in the composer                                     |
| `send`    | Set to `true` to submit the message immediately                      |
| `name`    | A custom name for the new session                                    |
| `window`  | `focused` to reuse the current window, or `full` for the full window |

For example, a one-click "summarize my day" bookmark:

```text theme={null}
synti://action/new-chat?input=Summarize%20today%27s%20flagged%20sessions&send=true&name=Daily%20recap
```

## Acting on a session

Target an existing session by its ID:

```text theme={null}
synti://action/flag-session/{sessionId}
synti://action/unflag-session/{sessionId}
synti://action/delete-session/{sessionId}
synti://action/rename-session/{sessionId}?name=New%20Name
```

## Navigating the app

Deep links can also jump straight to a view or a resource.

<CodeGroup>
  ```text Sessions & views theme={null}
  synti://allSessions
  synti://flagged
  synti://state/{statusId}
  ```

  ```text Resources theme={null}
  synti://sources/source/{sourceSlug}
  synti://skills/skill/{skillSlug}
  ```

  ```text Settings theme={null}
  synti://settings/workspace
  synti://settings/permissions
  synti://settings/shortcuts
  synti://settings/preferences
  ```
</CodeGroup>

## Targeting a workspace

By default a link acts on the current workspace. Prepend a workspace segment to direct it somewhere specific:

```text theme={null}
synti://workspace/{workspaceId}/action/new-chat?input=Deploy%20checklist&send=true
```

See [Workspaces](/go-further/workspaces) for where to find a workspace ID.

## Where deep links shine

<CardGroup cols={2}>
  <Card title="Browser bookmarks" icon="bookmark">
    Save a prompt you run often as a one-click bookmark.
  </Card>

  <Card title="Shell aliases" icon="terminal">
    Wrap a link in a shell function or `open`/`xdg-open` command.
  </Card>

  <Card title="Launchers" icon="magnifying-glass">
    Trigger sessions from Raycast, Alfred, or Spotlight.
  </Card>

  <Card title="Documentation" icon="link">
    Embed action links in runbooks and internal notes.
  </Card>
</CardGroup>

<Tip>
  Pair deep links with mobile shortcuts to hand a task to Synti from your phone, or with an [Automation](/automations/overview) to chain actions together.
</Tip>

## Related

<CardGroup cols={2}>
  <Card title="Workspaces" icon="layer-group" href="/go-further/workspaces">
    Scope links to a specific workspace.
  </Card>

  <Card title="Sharing" icon="share-nodes" href="/go-further/sharing">
    Publish a conversation as a link.
  </Card>
</CardGroup>