--- title: "PUT | Atualizar anotação" slug: "api-put-update-note" updated: 2026-03-04T12:05:21Z published: 2026-03-04T14:50:13Z canonical: "docs.senhasegura.io/api-put-update-note" --- > ## 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 anotação Atualize uma anotação no **MySafe**. ## Pré-requisitos - Permissão de edição da anotação no **MySafe**. ## Requisição ` PUT` `api/mysafe/note/update[identifier]` ## Parâmetros de requisição Envie os parâmetro abaixo no **path** da URL. identifier - int - obrigatório - Código único de identificação da anotação. Nota: esse valor é automaticamente atribuído pelo Segura® em POST | Criar anotação e é obtido na resposta da requisição GET | Listar todas as anotações.



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


Importante!

Anotações cujo conteúdo possui mais de 900 caracteres resultarão em erro.




    →username - string - Nome do usuário com permissão de acesso à anotação.


    →can_edit - boolean - Permissão de edição.     Nota: se deixado vazio, usuários terão apenas permissão de visualização.
Atenção

Usuários com permissão can_edit = true podem inativar a anotação



    →name - string - Nome do grupo com permissão de acesso à anotação.


    →can_edit - boolean - Permissão de edição.     Nota: se deixado vazio, membros do grupo terão apenas permissão de visualização.
Atenção

Membros de grupos com permissão can_edit = true podem inativar a anotação

Exemplo de requisição

{
   
    "users_allowed": [
        {
            "username" : "pduarte",
            "can_edit" : false
        }
    ]
}

Resposta

HTTP/1.1 200 OK

 {
    "code": 200,
    "response": {
        "status": 200,
        "message": "Note successfully update",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Note successfully update",
        "erro": false,
        "cod_erro": 0
    },
    "note_entity": {
        "identifier": "2",
        "name": "Secret note",
        "tags": "secret",
        "users_allowed": [
            {
                "username": "pduarte",
                "can_edit": false
            }
        ],
        "groups_allowed": [],
        "shared_error": []
    }
}

Erros

400 - Bad Request.

Mensagem: "1001: Parameter note limited to 900 characters"

Possível causa: o conteúdo enviado em note ultrapassou o limite de 900 caracteres.

Solução: diminua o conteúdo da anotação e envie a requisição novamente.
500 - Internal Server Error.

Mensagem: "Unexpected error."

Possível causa: o erro está no servidor Segura®.

Solução: contate o time de suporte para mais informações.

No route matched with those values.

Mensagem: "No route matched with those values."

Possíveis causas: falha na autenticação da sua aplicação com o servidor Segura® ou URL incorreta.

Solução: verifique os parâmetros de autenticação como Access Token URL, Client ID e Client Secret e solicite um novo token de acesso ou verifique e corrija a URL.

An invalid response was received from the upstream server .

Mensagem: "An invalid response was received from the a seupstream server

Possível causa: 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.

Solução: verifique a conectividade entre a origem da requisição e o servidor Segura®.

The upstream server is timing out.

Mensagem: "The upstream server is timing out"

Possível causa: o tempo da requisição se esgotou.

Solução: verifique a conectividade entre a origem da requisição e o servidor Segura®.