---
title: "PUT | Atualizar senha"
slug: "api-put-update-password"
updated: 2026-03-16T13:25:10Z
published: 2026-03-16T13:25:10Z
canonical: "docs.senhasegura.io/api-put-update-password"
---

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

# PUT | Atualizar senha

Atualize uma senha no **MySafe**.

## Pré-requisitos

- Permissão de edição de senha no **MySafe**.

## Requisição

` PUT` `api/mysafe/password/update[identifier]`

## Parâmetros de requisição

Envie o parâmetro abaixo no **path** da URL.

- <summary><code>identifier</code> - <b>int</b> - <span style="color:red">obrigatório</span> - Código único de identificação da senha.</summary>**Nota**: este valor é automaticamente atribuído pelo Segura® em [POST | Criar senha](/v4-2/docs/pt/api-post-create-password) e é obtido na resposta da requisição [GET | Listar todas as senhas](/v4-2/docs/pt/api-get-list-all-passwords).

Envie os parâmetros que deseja atualizar no **body** da requisição.

- <summary><code>name</code> - <b>string</b> - Nome atribuído à senha</summary>

- <summary><code>username</code> - <b>string</b>  - Nome de usuário usado para acessar a conta.</summary>

- <summary><code>password</code> - <b>string</b> - A senha que está sendo atualizada.</summary>

- <summary><code>url</code> - <b>string</b> - URL do site onde a senha está sendo usada.</summary>

- <summary><code>secret_key</code> - <b>string</b> - <i>Seed</i> para gerar automaticamente o TOTP.</summary>

**Nota**: deve estar codificada em base32.

- <summary><code>notes</code> - <b>string</b> - Observações adicionais sobre a senha.</summary>

- <summary><code>tags</code> - <b>string</b> - Palavras-chave associadas à senha.</summary>

- <summary><code>users_allowed</code> - <b>array de objetos</b> - Dados dos usuários com acesso à senha.</summary>**Nota**: o envio de um array vazio, remove as permissões de compartilhamento.

<summary>&nbsp;  &nbsp;→<code>username</code> - <b>string</b> - Nome do usuário com permissão de acesso à senha.</summary>

<summary>&nbsp;  &nbsp;→<code>can_edit</code> - <b>boolean</b> - Permissão de edição.</summary>
<summary>&nbsp;  &nbsp;<b>Nota</b>: se deixado vazio, usuários terão apenas permissão de visualização.
<p><br></p>
<section class="warningBox"><div class="title">Atenção</div>
<div class="content">
<p>Usuários  com permissão <code>can_edit</code> = <code>true</code> podem inativar uma senha.</p>
</div>
</section>
<p><br></p>
<ul>
<li>
<summary><code>groups_allowed</code> - <b>array de objetos</b> - Dados dos grupos com permissão de acesso à senha.</summary><b>Nota</b>: o envio de um array vazio, remove as permissões de compartilhamento.
</li>
</ul>
<p><br></p>
<summary>&nbsp;  &nbsp;→<code>name</code> - <b>string</b> - Nome do grupo com permissão de acesso à senha.</summary>
<p><br></p>
<summary>&nbsp;  &nbsp;→<code>can_edit</code> - <b>boolean</b> - Permissão de edição.</summary>
<summary>&nbsp;  &nbsp;<b>Nota</b>: se deixado vazio, membros do grupo terão apenas permissão de visualização.
<p><br></p>
<section class="warningBox"><div class="title">Atenção</div>
<div class="content">
<p>Membros de grupos com permissão <code>can_edit</code> = <code>true</code> podem inativar uma senha.</p>
</div>
</section>
<h3>Exemplo de requisição</h3>
<p><code><span style="color:blue"> PUT</span></code> <code data-backticks="1">api/mysafe/password/update/9</code></p>
<pre><code class="lang-json" data-language="json">{
    "name": "senseg account",
    "url": "www.segura.com",
    "username": "npass",
    "password": "8jhfy@3789",
    "secret_key": "JBSWY3DPEHPK3PXP",
    "notes": "Access details",
    "tags": "tag1, tag2",
    "users_allowed": [
        {
            "username" : "pduarte"
        }
    ],
    "groups_allowed": [
        {
            "name" : "Test group",
            "can_edit" : false
        }
    ]
}
</code></pre>
<h2>Resposta</h2>
<pre><code class="lang-json" data-language="json">HTTP/1.1 200 OK
</code></pre><pre><code class="lang-json" data-language="json"> {
    "code": 200,
    "response": {
        "status": 200,
        "message": "Password successfully updated",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Password successfully updated",
        "erro": false,
        "cod_erro": 0
    },
    "password_entity": {
        "identifier": "312",
        "name": "segura account",
        "url": "www.url.com",
        "username": "senhapass",
        "note": "Access details for this key.",
        "tags": "access",
        "users_allowed": [
            {
                "username": "pduarte",
                "can_edit": true
            }
        ],
        "groups_allowed": [
            {
                "name": "Test group",
                "can_edit": true
            }
        ],
        "shared_error": []
    }
}
</code></pre>
<h2>Erros</h2>
 <details>
<summary><b><span style="color:red">400</span> - Bad Request</b>.</summary>
<hr>

 <b>Mensagem: "1005: Password not found"</b>
<p><b>Possível causa</b>: senha não encontrada.<br></p>
<b>Solução</b>: verifique o valor do <code>identifier</code> e envie a requisição novamente.
<hr>

<b>Mensagem: "1006: User does not have access"</b>
<p><b>Possível causa</b>: usuário não possui acesso à senha.<br></p>
<hr>

</details><details>
    <summary><b><span style="color:red">500</span> - Internal Server Error</b>.</summary>
<hr>

<b>Mensagem: "Unexpected error."</b><br>

<p><b>Possível causa</b>: o erro está no servidor Segura®.<br>

<b>Solução</b>: contate o time de suporte para mais informações.</p>
<hr>

 </details> <details>
    <summary><b>No route matched with those values.</b></summary>
<hr>

<b>Mensagem: "You are not authorized to access this resource."</b>
<p><b>Possíveis causas</b>: falha na autenticação da sua aplicação com o servidor Segura® ou URL incorreta.<br>

<b>Solução</b>: verifique os parâmetros de autenticação como <code>Access Token URL</code>, <code>Client ID</code> e  <code>Client Secret</code> e solicite um novo token de acesso ou verifique e corrija a URL.
</p><hr>
</details><details>
<summary><b>An invalid response was received from the upstream server
</b>.</summary>
<hr>

<b>Mensagem: "An invalid response was received from the a seupstream server</b>

<p><b>Possível causa</b>: o servidor upstream pode estar demorando muito para responder, levando a um erro de timeout que é interpretado como uma resposta inválida pelo servidor proxy/gateway.<br>

<b>Solução</b>: verifique a conectividade entre a origem da requisição e o servidor Segura®.</p>
<hr>
</details><details>
<summary><b>The upstream server is timing out</b>.</summary>
<hr>

<b>Mensagem: "An invalid response was received from the upstream server"</b>

<p><b>Possível causa</b>: o tempo da requisição se esgotou.

<b>Solução</b>: verifique a conectividade entre a origem da requisição e o servidor Segura®.</p>
<hr>
</details>
</summary></summary>