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

# Store commands

> Browse and search apps and services across stores

Synthetiq has two types of stores:

* **Organization store** — Apps and services shared within your organization
* **Synthetiq store** — Core apps and services maintained by Synthetiq

## list

List available stores:

```bash theme={null}
synthetiq store list
```

```
ID                                     STORE       SLUG
23ef2ed2-13d3-48cd-ba23-b7942ace53ef   Acme Corp   acme-corp
b7942ace53ef-13d3-48cd-ba23-…          Synthetiq   synthetiq
```

| Flag     | Description    |
| -------- | -------------- |
| `--json` | Output as JSON |

## browse

Browse apps and services in a store:

```bash theme={null}
synthetiq store browse [options]
```

| Flag              | Default    | Description                             |
| ----------------- | ---------- | --------------------------------------- |
| `--store <store>` | All stores | Filter by store name or slug            |
| `--type <type>`   | All        | Filter by entity type: `app`, `service` |
| `--json`          | —          | Output as JSON                          |

```bash theme={null}
synthetiq store browse --store acme-corp --type app
```

```
ID                                     NAME                  TYPE       STORE       DESCRIPTION
0b54f3a8-91c2-4d7e-a6b1-8e2f5c9d3a10   workflow-manager      app        Synthetiq   Manage and monitor workflows
4c81d2e7-35f9-4b0a-9d63-1a7e8f2b6c54   shopify               service    Acme Corp   Shopify API integration
7d9e2f10-43aa-4c1e-9c70-2f6b1a8e5d23   github                service    Synthetiq   GitHub API integration
```

Browsing without `--store` covers every public store plus your own
organization's store (which is included even when it is not public). The `ID`
column is the entity ID that `versions`, `set-active`, `share`, and the
`publisher` commands take.

## search

Search for apps and services across all stores. Matches against entity name,
slug, and description:

```bash theme={null}
synthetiq store search <query>
```

```bash theme={null}
synthetiq store search "shopify"
```

```
ID                                     NAME                  TYPE       STORE       DESCRIPTION
4c81d2e7-35f9-4b0a-9d63-1a7e8f2b6c54   shopify               service    Acme Corp   Shopify API integration
1a7e8f2b-6c54-4d63-9b0a-35f94c81d2e7   shopify-analytics     app        Acme Corp   Shopify sales analytics dashboard
```

| Flag            | Description                  |
| --------------- | ---------------------------- |
| `--type <type>` | Filter by `app` or `service` |
| `--json`        | Output as JSON               |

## publications

List your organization's store publications:

```bash theme={null}
synthetiq store publications [--type <type>] [--json]
```

## publish

Publish an entity to your organization's store:

```bash theme={null}
synthetiq store publish <entity-id> [--public]
```

`--public` makes the listing visible outside the organization. Requires the
`entities:share_store` scope; not available in personal workspaces.

## unpublish

Remove an entity from your organization's store:

```bash theme={null}
synthetiq store unpublish <entity-id>
synthetiq store unpublish --publication-id <publication-id>
```

## shared list

List apps and services that have been shared directly with you:

```bash theme={null}
synthetiq shared list
```

```
ID                                     NAME                  TYPE       SHARED BY            DATE
0b54f3a8-91c2-4d7e-a6b1-8e2f5c9d3a10   internal-crm          app        admin@acme.com       Jun 10, 2026
4c81d2e7-35f9-4b0a-9d63-1a7e8f2b6c54   billing-service       service    dev@acme.com         Jun 8, 2026
```

| Flag            | Description                  |
| --------------- | ---------------------------- |
| `--type <type>` | Filter by `app` or `service` |
| `--json`        | Output as JSON               |

## shared by-me

List entities you have shared with others:

```bash theme={null}
synthetiq shared by-me [--type <type>] [--json]
```
