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

# Atualizar configurações

> Define as opções de comportamento da instância indicada no parâmetro de caminho `{instance}`.



## OpenAPI

````yaml openapi.evolution-v2.pt.json POST /settings/set/{instance}
openapi: 3.1.0
info:
  title: Evolution V2 Layer
  version: 1.0.0
  description: >-
    Camada de API do Pilot Status — Evolution V2. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-v2`. Autentique com o header
    `apikey` (sua chave `ps_` do Pilot Status). Endpoints de instância/sessão
    NÃO estão disponíveis na camada.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-v2
security:
  - apiKey: []
tags:
  - name: Chamada e Business
  - name: Chat
  - name: Grupo
  - name: Etiqueta (Label)
  - name: Mensagem
  - name: Perfil
  - name: Configurações e Proxy
  - name: Armazenamento (S3)
  - name: Template
paths:
  /settings/set/{instance}:
    post:
      tags:
        - Configurações e Proxy
      summary: Atualizar configurações
      description: >-
        Define as opções de comportamento da instância indicada no parâmetro de
        caminho `{instance}`.
      operationId: post__settings_set_instance
      parameters:
        - name: instance
          in: path
          required: true
          schema:
            type: string
          description: O nome de exibição do número no painel do Pilot Status.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                rejectCall:
                  type: boolean
                  description: Rejeita automaticamente as chamadas recebidas no WhatsApp.
                  example: true
                msgCall:
                  type: string
                  description: Mensagem enviada a quem liga quando uma chamada é rejeitada.
                  example: Sorry, I can't take calls right now.
                groupsIgnore:
                  type: boolean
                  description: Ignora mensagens vindas de grupos.
                  example: false
                alwaysOnline:
                  type: boolean
                  description: Mantém a presença da conexão como sempre online.
                  example: true
                readMessages:
                  type: boolean
                  description: Marca automaticamente as mensagens recebidas como lidas.
                  example: false
                readStatus:
                  type: boolean
                  description: >-
                    Marca automaticamente as atualizações de status/stories como
                    lidas.
                  example: false
                syncFullHistory:
                  type: boolean
                  description: Sincroniza todo o histórico de mensagens ao conectar.
                  example: false
                wavoipToken:
                  type: string
                  description: >-
                    Token WAVOIP usado para habilitar o tratamento de chamadas
                    de voz.
                  example: ''
              required:
                - rejectCall
                - groupsIgnore
                - alwaysOnline
                - readMessages
                - readStatus
                - syncFullHistory
      responses:
        '200':
          description: Sucesso — corpo de resposta nativo do provedor.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Confirmation that the instance settings were saved. Echoes the
                  instance name and the settings payload that was persisted.
                properties:
                  settings:
                    type: object
                    properties:
                      instanceName:
                        type: string
                        description: Name of the instance the settings were applied to.
                      settings:
                        type: object
                        description: The settings payload that was persisted.
                        properties:
                          rejectCall:
                            type: boolean
                            description: Automatically reject incoming WhatsApp calls.
                          msgCall:
                            type: string
                            description: >-
                              Message sent to the caller when a call is
                              auto-rejected.
                          groupsIgnore:
                            type: boolean
                            description: Ignore messages received from groups.
                          alwaysOnline:
                            type: boolean
                            description: Keep the connection presence as always online.
                          readMessages:
                            type: boolean
                            description: Automatically mark received messages as read.
                          readStatus:
                            type: boolean
                            description: Automatically mark status/stories as seen.
                          syncFullHistory:
                            type: boolean
                            description: Sync the full message history on connect.
                          wavoipToken:
                            type: string
                            description: WAVoIP token used to enable voice-call handling.
              example:
                settings:
                  instanceName: my-instance
                  settings:
                    rejectCall: true
                    msgCall: I can't take calls right now, please send a message.
                    groupsIgnore: false
                    alwaysOnline: true
                    readMessages: true
                    readStatus: false
                    syncFullHistory: false
                    wavoipToken: ''
        default:
          description: Erro — erro do provedor ou da camada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                  response:
                    type: object
              example:
                status: 400
                error: Bad Request
                message: Invalid payload
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Your Pilot Status API key (ps_...). Evolution GO also accepts
        `Authorization: Bearer <key>`.

````