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

# Get public catalog toolkit by slug

> Public detail for a global (non–project-scoped) toolkit, including SEO copy for the marketing page. Disabled and project toolkits are not returned.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/toolkits/bySlug/{slug}
openapi: 3.0.0
info:
  title: Flowra API (API Key Endpoints)
  description: >-
    **Flowra** is an AI-powered platform for building agents, workflows, and
    integrations.


    ### Capabilities

    - **Tools & Toolkits** – Define and group tools for agents and workflows.

    - **Workflows** – Orchestrate steps and automate processes.

    - **Triggers** – Schedule or event-based execution.

    - **Auth & Connections** – OAuth, API keys, and connected accounts.

    - **MCP** – Model Context Protocol server integration.

    - **Knowledge / RAG** – Add files and URLs for retrieval-augmented
    generation.


    ### Authentication

    Use the **x-api-key** header with a project API key to access endpoints that
    support API Key auth. Create and manage API keys in the dashboard under your
    project settings.


    Only endpoints that support API Key authentication via the @ApiKeyEnabled()
    decorator.


    Send x-api-key (required). On multi-tenant endpoints, optionally send
    x-username to act as an external user.
  version: '1.0'
  contact:
    name: Flowra
    url: https://flowra.dev
servers:
  - url: https://flowra.dev
    description: Flowra API
security: []
tags:
  - name: Users
    description: User profile
  - name: External Users
    description: End-user identities inside a project (x-username)
  - name: Auth Configs
    description: OAuth and API key configs for toolkits
  - name: Connected Accounts
    description: OAuth connected accounts and link creation
  - name: Toolkits
    description: List and search toolkits
  - name: Tools
    description: List, execute, and manage tools
  - name: Skills
    description: Browse, create, import, and install skills
  - name: Workflow & Agent
    description: Create, run, and inspect workflows and agents
  - name: Triggers
    description: Schedule and event-based trigger instances
  - name: Chat
    description: Threads and streaming agent runs
  - name: File
    description: Upload, list, and download files
  - name: Knowledge
    description: RAG knowledge collections
  - name: Table
    description: Collections and documents
  - name: Sandbox
    description: Ephemeral and durable code sandboxes
  - name: Browser
    description: Live browser sessions and view
  - name: LLM
    description: List AI models and generate completions
  - name: MCP
    description: MCP server management
  - name: usage
    description: Credit balance and usage ledger for the project API key
paths:
  /api/v1/toolkits/bySlug/{slug}:
    get:
      tags:
        - Toolkits
      summary: Get public catalog toolkit by slug
      description: >-
        Public detail for a global (non–project-scoped) toolkit, including SEO
        copy for the marketing page. Disabled and project toolkits are not
        returned.
      operationId: ToolkitsController_getPublicToolkitBySlug
      parameters:
        - name: slug
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Toolkit retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicToolkitDetailDtoSuccessResponse'
              example:
                success: true
                message: Operation completed successfully
                data:
                  id: ''
                  slug: slack
                  name: Slack
                  authSchemes:
                    - OAUTH2
                    - API_KEY
                  providerManagedAuthSchemes:
                    - OAUTH2
                  isDisabled: true
                  noAuth: false
                  createdAt: '2023-01-01T00:00:00Z'
                  updatedAt: '2023-01-01T00:00:00Z'
                  description: A comprehensive toolkit for productivity applications
                  logo: https://example.com/logo.png
                  appUrl: https://app.example.com
                  triggersCount: 15
                  toolsCount: 25
                  version: 1.0.0
                  availableVersions:
                    - 1.0.0
                    - 1.1.0
                    - 2.0.0
                  authConfigDetails:
                    - name: oauth2
                      mode: OAUTH2
                      fields:
                        authConfigCreation: {}
                        connectedAccountInitiation: {}
                      proxy:
                        baseUrl: ''
                      deprecatedAuthProviderDetails:
                        authorization_url: ''
                        token_url: ''
                  getCurrentUserEndpoint: /api/user
                  baseUrl: https://api.slack.com
                  provider: LOCAL
                  owner: true
                  popularityScore: 0
                  regions:
                    - IR
                    - US
                  categories:
                    - crm
                    - sales-&-customer-support
                  seatBilled: false
                  seo:
                    source: llm
                    generatedAt: ''
                    model: ''
                    locales: {}
                    en:
                      metaTitle: ''
                      metaDescription: ''
                      summary: ''
                      uses:
                        - ''
                      faqs:
                        - {}
                      keywords:
                        - ''
                    fa:
                      metaTitle: ''
                      metaDescription: ''
                      summary: ''
                      uses:
                        - ''
                      faqs:
                        - {}
                      keywords:
                        - ''
      security:
        - x-api-key: []
components:
  schemas:
    PublicToolkitDetailDtoSuccessResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Success status
          example: true
        message:
          type: string
          description: Success message
          example: Operation completed successfully
        data:
          type: object
          properties:
            id:
              type: string
              description: Toolkit id identifier
            slug:
              type: string
              description: Toolkit slug identifier
              example: slack
            name:
              type: string
              description: Toolkit display name
              example: Slack
            authSchemes:
              description: Available authentication schemes
              example:
                - OAUTH2
                - API_KEY
              type: array
              items:
                type: string
            providerManagedAuthSchemes:
              description: Provider-managed authentication schemes (e.g. Local or Composio)
              example:
                - OAUTH2
              type: array
              items:
                type: string
            isDisabled:
              type: boolean
              description: Whether toolkit is enabled
              example: true
            noAuth:
              type: boolean
              description: Whether this toolkit requires no authentication
              example: false
            createdAt:
              type: string
              description: Creation timestamp
              example: '2023-01-01T00:00:00Z'
            updatedAt:
              type: string
              description: Last update timestamp
              example: '2023-01-01T00:00:00Z'
            description:
              type: string
              description: Toolkit description
              example: A comprehensive toolkit for productivity applications
            logo:
              type: string
              description: Toolkit logo URL
              example: https://example.com/logo.png
            appUrl:
              type: string
              nullable: true
              description: Application URL
              example: https://app.example.com
            triggersCount:
              type: number
              description: Number of trigger tools (webhook/poll) available
              example: 15
            toolsCount:
              type: number
              description: Number of action tools available (excludes triggers)
              example: 25
            version:
              type: string
              description: Toolkit version
              example: 1.0.0
            availableVersions:
              description: Available versions
              example:
                - 1.0.0
                - 1.1.0
                - 2.0.0
              type: array
              items:
                type: string
            authConfigDetails:
              description: Authentication configuration details
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                    description: Auth provider name
                    example: oauth2
                  mode:
                    enum:
                      - OAUTH1
                      - OAUTH2
                      - S2S_OAUTH2
                      - API_KEY
                      - BASIC
                      - BEARER_TOKEN
                      - BILLCOM_AUTH
                      - GOOGLE_SERVICE_ACCOUNT
                      - NO_AUTH
                      - BASIC_WITH_JWT
                      - CALCOM_AUTH
                      - SERVICE_ACCOUNT
                      - SAML
                      - DCR_OAUTH
                      - COOKIE
                      - WHATSAPP_QR
                    type: string
                    description: Authentication mode
                    example: OAUTH2
                  fields:
                    type: object
                    properties:
                      authConfigCreation:
                        $ref: '#/components/schemas/AuthConfigCreationFieldsDto'
                      connectedAccountInitiation:
                        $ref: '#/components/schemas/AuthConfigCreationFieldsDto'
                    required:
                      - authConfigCreation
                      - connectedAccountInitiation
                  proxy:
                    type: object
                    properties:
                      baseUrl:
                        type: string
                    description: Proxy configuration
                  deprecatedAuthProviderDetails:
                    type: object
                    properties:
                      authorization_url:
                        type: string
                      token_url:
                        type: string
                    description: Deprecated auth provider details
                required:
                  - name
                  - mode
                  - fields
            getCurrentUserEndpoint:
              type: string
              description: Get current user endpoint
              example: /api/user
            baseUrl:
              type: string
              description: Base URL for the toolkit
              example: https://api.slack.com
            provider:
              enum:
                - COMPOSIO
                - LOCAL
              type: string
              description: Toolkit provider
              example: LOCAL
            owner:
              type: boolean
              description: Toolkit owner
            popularityScore:
              type: number
              description: Popularity score for ordering / ranking
              example: 0
            regions:
              nullable: true
              description: >-
                ISO 3166-1 alpha-2 region codes this toolkit is available in.
                null/empty = global.
              example:
                - IR
                - US
              type: array
              items:
                type: string
            categories:
              nullable: true
              description: Curated toolkit category ids. null/empty = uncategorized.
              example:
                - crm
                - sales-&-customer-support
              type: array
              items:
                type: string
            seatBilled:
              type: boolean
              description: >-
                When true, each ACTIVE connected account is billed a daily
                credit seat; tools in this toolkit do not charge per call.
              example: false
            seo:
              type: object
              properties:
                source:
                  type: string
                  enum:
                    - llm
                    - manual
                generatedAt:
                  type: string
                model:
                  type: string
                locales:
                  type: object
                  additionalProperties:
                    type: object
                    properties:
                      metaTitle:
                        type: string
                      metaDescription:
                        type: string
                      summary:
                        type: string
                      uses:
                        type: array
                        items:
                          type: string
                      faqs:
                        type: array
                        items:
                          $ref: '#/components/schemas/ToolkitSeoFaqDto'
                      keywords:
                        type: array
                        items:
                          type: string
                    required:
                      - metaTitle
                      - metaDescription
                      - summary
                      - uses
                      - faqs
                      - keywords
                  description: >-
                    SEO copy keyed by locale (en, fa, …). Add a language by
                    filling a new key; en is required.
                en:
                  type: object
                  properties:
                    metaTitle:
                      type: string
                    metaDescription:
                      type: string
                    summary:
                      type: string
                    uses:
                      type: array
                      items:
                        type: string
                    faqs:
                      type: array
                      items:
                        $ref: '#/components/schemas/ToolkitSeoFaqDto'
                    keywords:
                      type: array
                      items:
                        type: string
                  required:
                    - metaTitle
                    - metaDescription
                    - summary
                    - uses
                    - faqs
                    - keywords
                fa:
                  type: object
                  properties:
                    metaTitle:
                      type: string
                    metaDescription:
                      type: string
                    summary:
                      type: string
                    uses:
                      type: array
                      items:
                        type: string
                    faqs:
                      type: array
                      items:
                        $ref: '#/components/schemas/ToolkitSeoFaqDto'
                    keywords:
                      type: array
                      items:
                        type: string
                  required:
                    - metaTitle
                    - metaDescription
                    - summary
                    - uses
                    - faqs
                    - keywords
              required:
                - source
                - generatedAt
                - locales
                - en
              description: SEO copy for the public toolkit page. Catalog toolkits only.
          required:
            - id
            - slug
            - name
            - authSchemes
            - providerManagedAuthSchemes
            - isDisabled
            - noAuth
            - createdAt
            - updatedAt
            - description
            - logo
            - appUrl
            - triggersCount
            - toolsCount
            - version
            - availableVersions
            - authConfigDetails
            - getCurrentUserEndpoint
            - baseUrl
            - provider
          example:
            id: ''
            slug: slack
            name: Slack
            authSchemes:
              - OAUTH2
              - API_KEY
            providerManagedAuthSchemes:
              - OAUTH2
            isDisabled: true
            noAuth: false
            createdAt: '2023-01-01T00:00:00Z'
            updatedAt: '2023-01-01T00:00:00Z'
            description: A comprehensive toolkit for productivity applications
            logo: https://example.com/logo.png
            appUrl: https://app.example.com
            triggersCount: 15
            toolsCount: 25
            version: 1.0.0
            availableVersions:
              - 1.0.0
              - 1.1.0
              - 2.0.0
            authConfigDetails:
              - name: oauth2
                mode: OAUTH2
                fields:
                  authConfigCreation: {}
                  connectedAccountInitiation: {}
                proxy:
                  baseUrl: ''
                deprecatedAuthProviderDetails:
                  authorization_url: ''
                  token_url: ''
            getCurrentUserEndpoint: /api/user
            baseUrl: https://api.slack.com
            provider: LOCAL
            owner: true
            popularityScore: 0
            regions:
              - IR
              - US
            categories:
              - crm
              - sales-&-customer-support
            seatBilled: false
            seo:
              source: llm
              generatedAt: ''
              model: ''
              locales: {}
              en:
                metaTitle: ''
                metaDescription: ''
                summary: ''
                uses:
                  - ''
                faqs:
                  - {}
                keywords:
                  - ''
              fa:
                metaTitle: ''
                metaDescription: ''
                summary: ''
                uses:
                  - ''
                faqs:
                  - {}
                keywords:
                  - ''
      required:
        - success
        - message
        - data
    AuthConfigCreationFieldsDto:
      type: object
      properties:
        required:
          description: Required fields for auth config creation
          type: array
          items:
            $ref: '#/components/schemas/AuthConfigFieldDto'
        optional:
          description: Optional fields for auth config creation
          type: array
          items:
            $ref: '#/components/schemas/AuthConfigFieldDto'
      required:
        - required
        - optional
    ToolkitSeoFaqDto:
      type: object
      properties:
        q:
          type: string
        a:
          type: string
      required:
        - q
        - a
    AuthConfigFieldDto:
      type: object
      properties:
        name:
          type: string
          pattern: ^[A-Za-z][A-Za-z0-9_.-]{0,63}$
          description: >-
            Field name: starts with a letter, then letters, digits, underscore,
            dot or hyphen (max 64)
          example: client_id
        displayName:
          type: string
          description: Field display name
          example: Client ID
        default:
          type: string
          nullable: true
          description: Default value
          example: your_client_id
        type:
          type: string
          description: Field type
          example: string
        description:
          type: string
          description: Field description
          example: Your application client ID
        required:
          type: boolean
          description: Whether field is required
          example: true
        legacyTemplateName:
          type: string
          description: Legacy template name
          example: client_id
      required:
        - name
        - displayName
        - default
        - type
        - description
        - required
        - legacyTemplateName
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Project API key. Create and manage keys in the dashboard under Project →
        API Keys. Send as header: x-api-key: <your-key>

````