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

# Deploy plugin with inline assets (V2)

> Deploy a plugin with base64-encoded inline assets.

This endpoint is for external builders that generate assets client-side
and don't have their own CDN infrastructure.

**Authentication required**: API key must be authorized for the account.

**Request body:**
- **manifest**: Plugin manifest with name, version, pages, etc.
- **storeId**: The store ID to associate the plugin with
- **inlineAssets**: Array of assets with path, base64 content, and contentType
- **sourceData**: (optional) Source data for external editors (e.g., TagadaStudio FunnelTemplate)
- **overwrite**: Set to true to replace an existing deployment

**Returns:**
- **success**: Whether deployment succeeded
- **pluginId**: The generated plugin ID
- **deploymentId**: The deployment ID
- **version**: The deployed version
- **message**: Human-readable status message
- **uploadedFiles**: Number of files uploaded



## OpenAPI

````yaml /openapi.json post /api/public/v1/plugins/v2/deploy
openapi: 3.0.3
info:
  title: TagadaPay API
  description: >-

    # TagadaPay API Documentation


    Welcome to the TagadaPay API. This REST API lets you process payments,
    manage subscriptions, handle customers, deploy plugins, and orchestrate
    checkout funnels — all programmatically.


    ## Authentication


    Authenticate every request with a Bearer token. Get your API key from the
    [TagadaPay Dashboard](https://app.tagada.io).


    ```

    Authorization: Bearer your-api-key

    ```


    All requests must be made over HTTPS with `Content-Type: application/json`.


    ## Rate Limits


    | Plan | Requests/min | Burst |

    |------|-------------|-------|

    | Standard | 100 | 150 |

    | Premium | 500 | 750 |


    Exceeding the limit returns `429 Too Many Requests`.


    ## Errors


    | Code | Meaning |

    |------|---------|

    | 400 | Bad request — invalid parameters |

    | 401 | Unauthorized — missing or invalid API key |

    | 403 | Forbidden — insufficient permissions |

    | 404 | Not found |

    | 409 | Conflict |

    | 429 | Rate limited |

    | 500 | Server error |


    ## Support


    - Email: api-support@tagada.io

    - Docs: [docs.tagadapay.com](https://docs.tagadapay.com)
        
  version: 1.0.0
servers:
  - url: https://api.tagada.io/
    description: Production
  - url: https://api.tagada.dev/
    description: Sandbox / Development
security:
  - bearerAuth: []
tags:
  - name: auth
    description: Test your API key and verify authentication.
  - name: stores
    description: Create and manage stores within your account.
  - name: products
    description: Create products with variants, prices, and currency options.
  - name: customers
    description: Manage customer records, addresses, and payment instruments.
  - name: orders
    description: List and retrieve orders with line items, payments, and metadata.
  - name: payments
    description: Process, list, refund, void, and dispute payments.
  - name: subscriptions
    description: >-
      Create and manage recurring subscriptions — billing, cancellation,
      rebilling, and processor changes.
  - name: payment-flows
    description: Configure payment routing strategies with cascading processor fallbacks.
  - name: payment-instruments
    description: >-
      Manage stored payment methods — cards, bank accounts, and tokenized
      instruments.
  - name: processors
    description: List connected payment processors (Stripe, NMI, Checkout.com, etc.).
  - name: promotions
    description: Create and manage discount promotions with rules and conditions.
  - name: promotion-codes
    description: Generate and manage reusable promotion/coupon codes.
  - name: block-rules
    description: >-
      Configure fraud prevention rules to block transactions by IP, email, card
      BIN, country, etc.
  - name: webhooks
    description: Register webhook endpoints to receive real-time event notifications.
  - name: events
    description: Query application events, statistics, and audit logs.
  - name: domains
    description: Add, verify, and manage custom domains for your checkout and funnels.
  - name: funnels
    description: >-
      Create and manage checkout funnels with routing, A/B testing, and CDN
      deployment.
  - name: funnel-sessions
    description: Retrieve funnel session data for analytics and debugging.
  - name: funnel-tracking
    description: Track funnel step events for conversion analytics.
  - name: plugins
    description: Deploy, manage, and configure checkout plugins.
  - name: plugins-v2
    description: >-
      V2 plugin system — deploy, mount, split-test, fork, promote, and manage
      plugin instances.
  - name: checkout
    description: >-
      Initialize checkout sessions and process payments through the hosted
      checkout.
  - name: 3ds
    description: >-
      3D Secure authentication — create sessions, authenticate, and handle
      challenges.
  - name: builder
    description: Generate and validate builder session tokens for the visual page editor.
  - name: health
    description: API health check endpoint.
  - name: test
    description: Test and debugging utilities for the event system (sandbox only).
paths:
  /api/public/v1/plugins/v2/deploy:
    post:
      tags:
        - plugins-v2
      summary: Deploy plugin with inline assets (V2)
      description: >-
        Deploy a plugin with base64-encoded inline assets.


        This endpoint is for external builders that generate assets client-side

        and don't have their own CDN infrastructure.


        **Authentication required**: API key must be authorized for the account.


        **Request body:**

        - **manifest**: Plugin manifest with name, version, pages, etc.

        - **storeId**: The store ID to associate the plugin with

        - **inlineAssets**: Array of assets with path, base64 content, and
        contentType

        - **sourceData**: (optional) Source data for external editors (e.g.,
        TagadaStudio FunnelTemplate)

        - **overwrite**: Set to true to replace an existing deployment


        **Returns:**

        - **success**: Whether deployment succeeded

        - **pluginId**: The generated plugin ID

        - **deploymentId**: The deployment ID

        - **version**: The deployed version

        - **message**: Human-readable status message

        - **uploadedFiles**: Number of files uploaded
      operationId: post-api-public-v1-plugins-v2-deploy
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                manifest:
                  type: object
                  properties:
                    pluginId:
                      type: string
                    name:
                      type: string
                      minLength: 1
                    version:
                      type: string
                      minLength: 1
                    description:
                      type: string
                    category:
                      type: string
                    tags:
                      type: array
                      items:
                        type: string
                    mode:
                      type: string
                      enum:
                        - iframe-bridge
                        - direct-mode
                        - spa-mode
                      default: spa-mode
                    pages:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                          path:
                            type: string
                          name:
                            type: string
                          isDefault:
                            type: boolean
                          remappable:
                            type: boolean
                          features:
                            type: array
                            items:
                              type: object
                              properties:
                                type:
                                  type: string
                                requirements:
                                  type: array
                              required:
                                - type
                              additionalProperties: false
                          editor:
                            type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - internal
                                  - external
                                  - iframe
                                  - none
                              url:
                                type: string
                            required:
                              - type
                            additionalProperties: false
                        required:
                          - id
                          - path
                          - name
                        additionalProperties: false
                    requirements:
                      type: object
                      properties:
                        sdk:
                          type: string
                        sdkVersion:
                          type: string
                      additionalProperties: false
                    config:
                      type: object
                      additionalProperties: {}
                    ui:
                      type: object
                      properties:
                        hideDesignSelector:
                          type: boolean
                        hideVersionSelector:
                          type: boolean
                        hideConfigEditor:
                          type: boolean
                      additionalProperties: false
                  required:
                    - name
                    - version
                    - pages
                  additionalProperties: false
                storeId:
                  type: string
                  minLength: 1
                inlineAssets:
                  type: array
                  items:
                    type: object
                    properties:
                      path:
                        type: string
                      content:
                        type: string
                      contentType:
                        type: string
                    required:
                      - path
                      - content
                    additionalProperties: false
                zipUrl:
                  type: string
                  format: uri
                demoPreviews:
                  type: object
                  properties:
                    pages:
                      type: array
                      items:
                        type: object
                        properties:
                          path:
                            type: string
                          name:
                            type: string
                          previews:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                previewUrl:
                                  type: string
                                metadata:
                                  type: object
                                  properties:
                                    preset:
                                      type: string
                                    status:
                                      type: string
                                      enum:
                                        - pending
                                        - captured
                                        - failed
                                    capturedAt:
                                      type: string
                                    error:
                                      type: string
                                  required:
                                    - status
                                  additionalProperties: false
                                screenshotUrls:
                                  type: object
                                  properties:
                                    mobile:
                                      type: string
                                    desktop:
                                      type: string
                                  additionalProperties: false
                              required:
                                - id
                              additionalProperties: false
                        required:
                          - path
                          - previews
                        additionalProperties: false
                    metadata:
                      type: object
                      properties:
                        lastUpdated:
                          type: string
                        generator:
                          type: string
                        version:
                          type: string
                      additionalProperties: false
                  required:
                    - pages
                  additionalProperties: false
                sourceData:
                  type: object
                  additionalProperties: {}
                overwrite:
                  type: boolean
                  default: false
                autoInstantiate:
                  type: object
                  properties:
                    stepType:
                      type: string
                    funnelId:
                      type: string
                    isPreview:
                      type: boolean
                      default: true
                  required:
                    - stepType
                  additionalProperties: false
              required:
                - manifest
                - storeId
              additionalProperties: false
            examples:
              basic:
                summary: Deploy a simple landing page
                value:
                  manifest:
                    name: My Landing Page
                    version: 1.0.0
                    description: A simple landing page
                    category: landing
                    mode: spa-mode
                    pages:
                      - id: landing-main
                        path: /
                        name: Landing Page
                        isDefault: true
                        features:
                          - type: landing
                  storeId: store_abc123
                  inlineAssets:
                    - path: /index.html
                      content: PGh0bWw+PGJvZHk+SGVsbG8gV29ybGQ8L2JvZHk+PC9odG1sPg==
                      contentType: text/html
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema: {}
        default:
          $ref: '#/components/responses/error'
      security:
        - bearerAuth: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Enter your API key as: `Bearer your-api-key`'

````