---
updatedAt: 2026-03-28T21:17:53.000Z
agentTools:
  projectIndex: https://developers.vindi.com.br/llms.txt
---

# /v1/merchant_users/{id}

Remove um usuário associado.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "API Vindi",
    "version": "v1"
  },
  "servers": [
    {
      "url": "//app.vindi.com.br/api",
      "description": "Produção"
    },
    {
      "url": "//sandbox-app.vindi.com.br/api",
      "description": "SandBox"
    },
    {
      "url": "//app.vindi-dev.com/api",
      "description": "Staging"
    }
  ],
  "security": [
    {
      "basic_auth": []
    }
  ],
  "tags": [
    {
      "name": "merchant_users",
      "description": "Usuários associados"
    }
  ],
  "paths": {
    "/v1/merchant_users/{id}": {
      "delete": {
        "tags": [
          "merchant_users"
        ],
        "description": "Remove um usuário associado.",
        "operationId": "deleteV1MerchantUsersId",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Usuário removido com sucesso.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MerchantUser"
                }
              }
            }
          },
          "400": {
            "description": "Erro de sintaxe JSON no corpo do request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Errors"
                }
              }
            }
          },
          "404": {
            "description": "Usuário não encontrado.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Errors"
                }
              }
            }
          },
          "422": {
            "description": "Parâmetros inválidos. Verificar erro na resposta.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Errors"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Errors": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Error"
            }
          }
        },
        "description": "Este método permite o cadastro de perfis de pagamento através de uma API específica para chamadas Javascript no browser do seu cliente. Com esta função você reduz o escopo PCI do seu projeto pois os dados do cartão de crédito não irão trafegador em seus servidores.\n\nOs parâmetros são praticamente os mesmos do método `POST /payment_profiles`. Para mais informações sobre o cadastro assíncrono via Javascript, consulte este artigo.\n"
      },
      "Error": {
        "required": [
          "id",
          "message"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Chave identificadora do erro"
          },
          "parameter": {
            "type": "string",
            "description": "Parâmetros do erro"
          },
          "message": {
            "type": "string",
            "description": "Detalhes do erro"
          }
        }
      },
      "MerchantUser": {
        "required": [
          "id",
          "last_sign_in_at",
          "role",
          "status",
          "user"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id",
            "format": "int32"
          },
          "status": {
            "type": "string",
            "description": "Status"
          },
          "last_sign_in_at": {
            "type": "string",
            "description": "Último login"
          },
          "user": {
            "$ref": "#/components/schemas/Summary"
          },
          "role": {
            "$ref": "#/components/schemas/Full"
          }
        },
        "description": "Utilize este método para listar os Usuários de um determinado merchant. Leia a documentação sobre [paginação](http://atendimento.vindi.com.br/hc/pt-br/articles/203020644#pagination) e [filtros de busca](http://atendimento.vindi.com.br/hc/pt-br/articles/204163150).\n\n#### Atributos para busca\n<code>id</code>, <code>email</code> e <code>status</code>.\n"
      },
      "Summary": {
        "required": [
          "created_at",
          "email",
          "id",
          "name",
          "status"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "Nome"
          },
          "email": {
            "type": "string",
            "description": "E-mail"
          },
          "status": {
            "type": "string",
            "description": "Status"
          },
          "created_at": {
            "type": "string",
            "description": "Created at"
          }
        }
      },
      "Full": {
        "required": [
          "base_role",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "Translated name"
          },
          "base_role": {
            "type": "string",
            "description": "Perfil básico"
          }
        },
        "description": "Retorna o usuário atual."
      }
    },
    "securitySchemes": {
      "basic_auth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```