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

# Atualizar Posições dos Order Bumps

> Altere a ordem de exibição dos order bumps no checkout. A posição define qual oferta aparece primeiro para o cliente.

#### Escopo

```bash theme={null}
    write products
```

## Quando usar

* Reordenar as ofertas para priorizar a que mais converte
* Testar diferentes sequências de exibição
* Ajustar a hierarquia após adicionar um novo order bump

## Como funciona

Envie um array com os `id` dos order bumps e suas novas `position`. A API atualiza a ordem de exibição no checkout automaticamente.

<Tip>
  A oferta na posição 1 aparece primeiro. Coloque seu melhor conversor no topo.
</Tip>

<Note>
  Ids de order bump que não pertencem ao produto são **ignorados silenciosamente** — não geram erro, apenas não são atualizados. Confira a resposta ou liste os order bumps depois para validar que todos foram reordenados.
</Note>


## OpenAPI

````yaml POST /public_api/products/{id}/bumps/position_update/
openapi: 3.0.3
info:
  title: Cakto API
  version: 1.0.0
  description: Documentação da API pública do Cakto.
servers:
  - url: https://api.cakto.com.br
    description: Cakto API
security: []
paths:
  /public_api/products/{id}/bumps/position_update/:
    post:
      tags:
        - order-bumps
      description: |-
        Public API for managing order bumps, inherits from OrderBumpAPI,
        customizes authentication and permission settings.
      operationId: order_bumps_position_update
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/OrderBumpPositionUpdate'
          application/x-www-form-urlencoded:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/OrderBumpPositionUpdate'
          multipart/form-data:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/OrderBumpPositionUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderBumpPositionUpdate200'
              examples:
                Successo:
                  value:
                    detail: Posições atualizadas com sucesso.
          description: Corpo da resposta status 200
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderBumpCreate400'
              examples:
                ProdutoNãoEncontrado:
                  value:
                    detail: Produto não encontrado.
                OrderBumpNãoEncontrado:
                  value:
                    detail: Order bump não encontrado.
          description: Corpo da resposta status 400
        '401':
          description: Request não autenticado devido à ausência ou invalidez do token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthenticatedError'
              examples:
                Token ausente ou inválido:
                  $ref: '#/components/examples/UnauthenticatedErrorExample'
      security:
        - OAuth Token: []
components:
  schemas:
    OrderBumpPositionUpdate:
      type: object
      properties:
        id:
          type: string
          description: Id do order bump
        position:
          type: integer
          description: Nova posição do order bump
      required:
        - id
        - position
    OrderBumpPositionUpdate200:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
    OrderBumpCreate400:
      type: object
      properties:
        campo:
          type: string
        detail:
          type: string
    UnauthenticatedError:
      type: object
      properties:
        detail:
          type: string
  examples:
    UnauthenticatedErrorExample:
      summary: Token ausente ou inválido
      description: Token ausente ou inválido
      value:
        detail: As credenciais de autenticação não foram fornecidas.
  securitySchemes:
    OAuth Token:
      type: http
      scheme: bearer
      in: header
      name: Authorization
      description: >-
        Token de autenticação do tipo `Bearer {access_token}`, onde
        `{access_token}` é o token obtido no fluxo de
        [autenticação](/authentication).

````