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

# Definir ordem completa dos módulos

> Use IDs da árvore retornada por getMemberCourse; o curso e seus recursos pertencem exclusivamente à empresa do token. Envie todos os IDs deste conjunto exatamente uma vez, na ordem completa desejada.



## OpenAPI

````yaml /openapi.yaml put /v1/member-courses/{courseId}/modules/order
openapi: 3.0.3
info:
  title: Ephra API
  description: >-
    API pública da Ephra: cobranças (PIX, cartão e boleto), transações, webhooks
    e a API do vendedor sobre catálogo, checkout, vendas, reembolsos,
    financeiro, crescimento e plataforma.


    **Limite de requisições.** 1000 requisições por minuto por IP de origem.
    Toda resposta traz `x-ratelimit-limit`, `x-ratelimit-remaining` e
    `x-ratelimit-reset` (segundos até a janela zerar); ao estourar o limite a
    resposta é `429` com `retry-after`.


    **Um `429` que não é limite de requisições.** Em `POST /v1/card` e `POST
    /v1/subscriptions`, um `429` com `code: "BUYER_ATTEMPTS_EXCEEDED"` no corpo
    significa que este comprador, e só ele, está bloqueado para pagar com cartão
    depois de tentativas recusadas em excesso. Nada foi cobrado. Não pause nem
    atrase as cobranças de outros compradores por causa dele, e não repita a
    cobrança deste comprador antes de `blockedUntil` (ISO 8601 UTC, também em
    `retryAfterSeconds` e no header `retry-after`; os dois campos vêm `null`
    quando o horário não é conhecido). Pix continua disponível para o mesmo
    comprador. Diferencie os dois casos sempre pelo `code`, nunca pelo status.


    **Erros.** Toda falha responde o mesmo envelope: `{ "success": false,
    "message": "..." }`.
  version: 1.0.0
servers:
  - url: https://api.ephra.io
    description: Servidor de produção
security: []
tags:
  - name: Catálogo
    description: Produtos, ofertas, categorias e cupons — o que a empresa vende.
  - name: Checkout
    description: Checkouts, order bumps, upsells e links de pagamento.
  - name: Vendas
    description: Vendas, clientes, assinaturas e entregas já realizadas.
  - name: Reembolsos
    description: Pedidos de reembolso, contestações e o quiz de retenção.
  - name: Financeiro
    description: Saldo, saques, antecipações, taxas e extratos da empresa.
  - name: Crescimento
    description: Afiliados, coprodução, indicações, pixels e integrações de marketing.
  - name: Plataforma
    description: Conta, membros, chaves de API, webhooks e configurações gerais.
paths:
  /v1/member-courses/{courseId}/modules/order:
    put:
      tags:
        - Catálogo
      summary: Definir ordem completa dos módulos
      description: >-
        Use IDs da árvore retornada por getMemberCourse; o curso e seus recursos
        pertencem exclusivamente à empresa do token. Envie todos os IDs deste
        conjunto exatamente uma vez, na ordem completa desejada.
      operationId: reorderMemberModules
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 128
          in: path
          name: courseId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 128
                  maxItems: 1000
              required:
                - ids
              additionalProperties: false
            example:
              ids: []
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `true` em uma resposta bem-sucedida.
                  data:
                    type: object
                    properties:
                      cover:
                        type: object
                        properties:
                          url:
                            type: string
                            format: uri
                          alt:
                            type: string
                            maxLength: 500
                            nullable: true
                          expiresAt:
                            type: string
                            format: date-time
                            nullable: true
                        required:
                          - url
                          - alt
                          - expiresAt
                        additionalProperties: false
                        nullable: true
                      id:
                        type: string
                      slug:
                        type: string
                      kind:
                        type: string
                        enum:
                          - course
                          - bonus
                      status:
                        type: string
                        enum:
                          - draft
                          - published
                      title:
                        type: string
                      producerName:
                        type: string
                      tagline:
                        type: string
                      description:
                        type: string
                      category:
                        type: string
                      level:
                        type: string
                      highlights:
                        type: array
                        items:
                          type: string
                      certificateHours:
                        type: integer
                        minimum: 0
                      productId:
                        type: string
                      instructor:
                        type: object
                        properties:
                          name:
                            type: string
                          role:
                            type: string
                          bio:
                            type: string
                          initials:
                            type: string
                        required:
                          - name
                          - role
                          - bio
                          - initials
                        additionalProperties: false
                      artwork:
                        type: object
                        properties:
                          from:
                            type: string
                          via:
                            type: string
                          to:
                            type: string
                          glow:
                            type: string
                          motif:
                            type: string
                            enum:
                              - bars
                              - circle
                              - grid
                              - spark
                              - waves
                        required:
                          - from
                          - via
                          - to
                          - glow
                          - motif
                        additionalProperties: false
                      enrolledAt:
                        type: string
                        format: date-time
                        nullable: true
                      modules:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            title:
                              type: string
                            lessons:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  slug:
                                    type: string
                                  title:
                                    type: string
                                  summary:
                                    type: string
                                  kind:
                                    type: string
                                    enum:
                                      - video
                                      - reading
                                  durationSeconds:
                                    type: integer
                                    minimum: 0
                                  releaseAfterDays:
                                    type: integer
                                    minimum: 0
                                    nullable: true
                                  released:
                                    type: boolean
                                  body:
                                    type: array
                                    items:
                                      type: string
                                  image:
                                    type: object
                                    properties:
                                      url:
                                        type: string
                                        format: uri
                                      alt:
                                        type: string
                                        maxLength: 500
                                        nullable: true
                                      expiresAt:
                                        type: string
                                        format: date-time
                                        nullable: true
                                    required:
                                      - url
                                      - alt
                                      - expiresAt
                                    additionalProperties: false
                                    nullable: true
                                  youtubeVideoId:
                                    type: string
                                    nullable: true
                                  embedUrl:
                                    type: string
                                    format: uri
                                    nullable: true
                                  materials:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                        title:
                                          type: string
                                        kind:
                                          type: string
                                          enum:
                                            - link
                                            - pdf
                                            - sheet
                                        url:
                                          type: string
                                          format: uri
                                        sizeLabel:
                                          type: string
                                          nullable: true
                                      required:
                                        - id
                                        - title
                                        - kind
                                        - url
                                        - sizeLabel
                                      additionalProperties: false
                                  comments:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                        authorName:
                                          type: string
                                        body:
                                          type: string
                                        isInstructor:
                                          type: boolean
                                        postedAt:
                                          type: string
                                          format: date-time
                                        ownedByViewer:
                                          type: boolean
                                      required:
                                        - id
                                        - authorName
                                        - body
                                        - isInstructor
                                        - postedAt
                                        - ownedByViewer
                                      additionalProperties: false
                                required:
                                  - id
                                  - slug
                                  - title
                                  - summary
                                  - kind
                                  - durationSeconds
                                  - releaseAfterDays
                                  - released
                                  - body
                                  - image
                                  - youtubeVideoId
                                  - embedUrl
                                  - materials
                                  - comments
                                additionalProperties: false
                          required:
                            - id
                            - title
                            - lessons
                          additionalProperties: false
                    required:
                      - cover
                      - id
                      - slug
                      - kind
                      - status
                      - title
                      - producerName
                      - tagline
                      - description
                      - category
                      - level
                      - highlights
                      - certificateHours
                      - productId
                      - instructor
                      - artwork
                      - enrolledAt
                      - modules
                    additionalProperties: false
                required:
                  - success
                  - data
                additionalProperties: false
              example:
                success: true
                data:
                  id: course_ia
                  productId: product_ia
                  slug: ia-pratica
                  kind: course
                  status: draft
                  title: IA prática
                  producerName: Escola Ephra
                  tagline: ''
                  description: ''
                  category: ''
                  level: ''
                  highlights: []
                  certificateHours: 0
                  instructor:
                    name: Ana
                    role: ''
                    bio: ''
                    initials: A
                  artwork:
                    from: '#1d0b33'
                    via: '#8533ea'
                    to: '#07050b'
                    glow: '#d5b8f8'
                    motif: circle
                  cover: null
                  enrolledAt: null
                  modules: []
        '400':
          description: A requisição está bem formada, mas uma regra de negócio a recusou.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  A requisição está bem formada, mas uma regra de negócio a
                  recusou.
              example:
                success: false
                message: >-
                  Não foi possível concluir: uma regra de negócio recusou os
                  dados enviados.
        '401':
          description: Token ausente, inválido, expirado ou de empresa bloqueada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: Token ausente, inválido, expirado ou de empresa bloqueada.
              example:
                success: false
                message: Token inválido ou expirado
        '404':
          description: O recurso não existe, foi excluído ou pertence a outra empresa.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  O recurso não existe, foi excluído ou pertence a outra
                  empresa.
              example:
                success: false
                message: Recurso não encontrado
        '409':
          description: O recurso não aceita esta operação no estado em que se encontra.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  O recurso não aceita esta operação no estado em que se
                  encontra.
              example:
                success: false
                message: >-
                  O recurso não aceita esta operação no estado em que se
                  encontra.
        '422':
          description: A requisição não passou na validação de schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: A requisição não passou na validação de schema.
              example:
                success: false
                message: 'name: Nome é obrigatório'
        '429':
          description: >-
            Requisições demais: o limite é de 1000 requisições por minuto por IP
            de origem. Espere o número de segundos do header `retry-after` e
            repita com recuo exponencial.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Requisições demais: o limite é de 1000 requisições por minuto
                  por IP de origem. Espere o número de segundos do header
                  `retry-after` e repita com recuo exponencial.
              example:
                success: false
                message: Muitas requisições. Tente novamente em breve.
          headers:
            retry-after:
              $ref: '#/components/headers/retry-after'
            x-ratelimit-limit:
              $ref: '#/components/headers/x-ratelimit-limit'
            x-ratelimit-remaining:
              $ref: '#/components/headers/x-ratelimit-remaining'
            x-ratelimit-reset:
              $ref: '#/components/headers/x-ratelimit-reset'
        '500':
          description: >-
            Falha interna ao processar a requisição. Repita; se persistir, abra
            chamado com o horário e a rota.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Falha interna ao processar a requisição. Repita; se persistir,
                  abra chamado com o horário e a rota.
              example:
                success: false
                message: Erro interno do servidor
      security:
        - bearerAuth: []
components:
  headers:
    retry-after:
      description: Segundos a esperar antes de repetir a requisição.
      schema:
        type: integer
    x-ratelimit-limit:
      description: Teto de requisições na janela (1000). Presente em toda resposta.
      schema:
        type: integer
    x-ratelimit-remaining:
      description: >-
        Quantas requisições ainda cabem na janela atual. Presente em toda
        resposta.
      schema:
        type: integer
    x-ratelimit-reset:
      description: Segundos até o contador da janela zerar. Presente em toda resposta.
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.