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

# Update a pricing template

> Updates strategy-specific arguments for a pricing template. The path id is mapped to templateId internally. Optionally set the template's price-change market (priceChangeSource + priceChangeCountry, both or neither; null/null clears it to the shop default). Omitting both leaves the market unchanged. Changing the market re-prices variants bound to this template; passing variantId binds that variant and clears its own market override.



## OpenAPI

````yaml /openapi.json patch /pricing-templates/{id}
openapi: 3.1.0
info:
  title: PricePirate Admin API
  version: 1.0.0
  description: >-
    Rate limits: each shop can send 60 requests per minute across all API keys.
    If the limit is exceeded, the API returns 429 TOO_MANY_REQUESTS with a
    Retry-After header.
servers:
  - url: https://app.pricepirate.com/api/v1
security:
  - bearerAuth: []
tags:
  - name: catalog
    x-group: Catalog
  - name: listings
    x-group: Listings
  - name: metrics
    x-group: Metrics
  - name: price-changes
    x-group: Price changes
  - name: pricing
    x-group: Pricing
  - name: reports
    x-group: Reports
  - name: shop
    x-group: Shop
  - name: tracked-variants
    x-group: Tracked variants
paths:
  /pricing-templates/{id}:
    patch:
      tags:
        - pricing
      summary: Update a pricing template
      description: >-
        Updates strategy-specific arguments for a pricing template. The path id
        is mapped to templateId internally. Optionally set the template's
        price-change market (priceChangeSource + priceChangeCountry, both or
        neither; null/null clears it to the shop default). Omitting both leaves
        the market unchanged. Changing the market re-prices variants bound to
        this template; passing variantId binds that variant and clears its own
        market override.
      operationId: pricing.updateTemplate
      parameters:
        - name: id
          in: path
          description: Pricing template ID.
          required: true
          schema:
            type: string
          example: template-123
        - name: Idempotency-Key
          in: header
          description: >-
            Required for write requests. Reuse the same key only when retrying
            the exact same request.
          required: true
          schema:
            type: string
          example: 7f8c2e9d-8c7f-4f2c-9f35-6cc1819a7f3f
      requestBody:
        description: Updated template arguments.
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties: {}
                  additionalProperties: true
                variantId:
                  type: string
                priceChangeSource:
                  oneOf:
                    - type: string
                      enum:
                        - IDEALO
                        - GOOGLE_SHOPPING
                        - KLARNA
                        - PRICERUNNER
                        - ALLEGRO
                        - AMAZON
                    - type: 'null'
                priceChangeCountry:
                  oneOf:
                    - type: string
                      enum:
                        - AE
                        - AT
                        - AU
                        - BE
                        - BG
                        - BR
                        - CA
                        - CH
                        - CN
                        - CZ
                        - DE
                        - DK
                        - ES
                        - FI
                        - FR
                        - GR
                        - HR
                        - HU
                        - IE
                        - IN
                        - IT
                        - JP
                        - NL
                        - 'NO'
                        - PL
                        - PT
                        - RO
                        - MX
                        - SE
                        - SK
                        - UK
                        - US
                    - type: 'null'
              required:
                - args
              additionalProperties: false
            example:
              args:
                marginPercent: 10
              variantId: gid://shopify/ProductVariant/1001
              priceChangeSource: IDEALO
              priceChangeCountry: DE
      responses:
        '200':
          description: Successful response.
          headers:
            Idempotency-Replayed:
              description: >-
                Present with value true when a write response was served from
                the idempotency cache.
              schema:
                type: string
                enum:
                  - 'true'
              example: 'true'
          content:
            application/json:
              schema: {}
              example:
                success: true
                templateId: template-123
                affectedVariantsCount: 4
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/DefaultError'
components:
  responses:
    BadRequest:
      description: Bad request or validation error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: BAD_REQUEST
              message: JSON body must be an object
              details: Validation details may be included for invalid inputs.
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
    Unauthorized:
      description: Missing or invalid bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: UNAUTHORIZED
              message: Missing or invalid Authorization header
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
    Forbidden:
      description: The token is valid but the request is not allowed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: FORBIDDEN
              message: Forbidden
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
    NotFound:
      description: Endpoint or domain resource not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: NOT_FOUND
              message: Resource not found
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
    Conflict:
      description: Write conflict, including idempotency key reuse or in-progress locks.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: idempotency_key_reuse
              message: Idempotency-Key was already used for a different request
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
    TooManyRequests:
      description: Rate limit exceeded.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: string
          example: '60'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: TOO_MANY_REQUESTS
              message: Rate limit exceeded
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
    InternalServerError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INTERNAL_SERVER_ERROR
              message: Internal server error
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
    DefaultError:
      description: Unexpected error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INTERNAL_SERVER_ERROR
              message: Internal server error
              requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f
  schemas:
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - message
            - requestId
          properties:
            code:
              type: string
              description: >-
                Runtime error code. Examples include BAD_REQUEST, UNAUTHORIZED,
                FORBIDDEN, NOT_FOUND, CONFLICT, TOO_MANY_REQUESTS,
                INTERNAL_SERVER_ERROR, idempotency_key_required,
                idempotency_key_reuse, and idempotency_key_in_progress.
            message:
              type: string
            details:
              description: >-
                Additional validation details, typically present on 400
                responses.
            requestId:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Public API token passed as Authorization: Bearer <token>.'

````