---
title: "List Shortcuts"
method: GET
path: "/api/v1/shortcuts/"
tags: ["Shortcuts"]
---

# List Shortcuts

`GET /api/v1/shortcuts/`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/shortcuts/`
- Auth: HTTP bearer

Returns all shortcuts accessible to the authenticated user. Optionally filter by ownership type: `master` (shortcuts you created), `shared` (shortcuts shared with you or published to your whole organization), or `all` (both). Defaults to all. Use `search` to find shortcuts by what they do: it matches their name, description, inputs and outputs. Shortcuts with `callable: true` can be called from a workflow through the `call_shortcut` action.

## Query parameters

- `filter` 'master' | 'shared' | 'all'
- `search` string

## Response `200`

Default Response

- object
  - `status` integer
  - `data` Shortcut[]
    - `id` string: Unique shortcut identifier (UUID)
    - `workflow_id` string: UUID of the underlying workflow that powers this shortcut
    - `parent_app_id` string, nullable: If this is a shared copy, the ID of the original master shortcut. Null for master shortcuts.
    - `floqer_catalog_id` string: Global identity when this shortcut is shared across organizations.
    - `call_shortcut_id` string: Source shortcut ID accepted by a Call Shortcut workflow action.
    - `floqer_source_version` integer: Current published source version for a global shortcut.
    - `is_virtual` boolean: Whether this shortcut is a read-only projection.
    - `name` string: Shortcut display name
    - `description` string: Human-readable description of what the shortcut does
    - `creator_email` string: Email of the user who created the shortcut
    - `org_id` string: Organization ID the shortcut belongs to
    - `visibility` string, nullable: Get Shortcut only. `org`: everyone in the organization can use it. `private`: its creator and the people it is shared with. Null for a shortcut published before versioning.
    - `shared_users` string[]: Get Shortcut only. Emails it is shared with (use access). Populated for the shortcut's creator; otherwise `[]`.
    - `input_schema` InputField[]: Ordered list of input fields — derived from the workflow's input action (id1)
      - `reference` string: Snake_case identifier for this input field (derived from `name`) — use it as the key in `input_data` when running the shortcut
      - `name` string: Human-readable field name displayed in the shortcut UI
      - `description` string: Help text describing what value to provide for this field
      - `type` string: Field type: text, number, email, url, etc.
      - `required` boolean: Whether this field must be provided when running the shortcut
      - `defaultValue` unknown
    - `output_schema` OutputConfig[]: Ordered list of output fields — derived from the workflow's OUTPUT_CUSTOM_ENRICHMENT action
      - `name` string: Human-readable name for this output field — the key for its value in a run's `output_data`
      - `description` string: Description of what this output contains
      - `display_column` string: Column header label shown in results tables
    - `is_master` boolean: True if this is the original shortcut (not a shared copy)
    - `is_published` boolean: Whether the shortcut is published and available for runs
    - `is_archived` boolean: Whether the shortcut has been archived
    - `callable` boolean: Whether a workflow can call this shortcut: set its `id` as `shortcut` on a `call_shortcut` action. False until the shortcut has a published version; republish it in the Floqer app.
    - `extensions` object: Browser extensions that can trigger this shortcut, each with the input (by `reference`) it fills from the page. `{}` when none can. A `null` input means that extension is on but its input is no longer on the shortcut, so it fills nothing: set a new input or turn it off.
      - `linkedin` string, nullable: The input the LinkedIn extension fills from the profile page, by its `reference`.
      - `sales_navigator` string, nullable: The input the Sales Navigator extension fills from the page, by its `reference`.
    - `cover_image` string, nullable: URL of the shortcut's cover image
    - `icon_emoji` string, nullable: Emoji used as the shortcut icon
    - `created_at` string, date-time: When the shortcut was created
    - `updated_at` string, date-time: When the shortcut was last updated

## Other responses

- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction).
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)