Editar pasta

PATCH

/documents/folders/edit

Altera o nome de uma pasta e, opcionalmente, a etiqueta e os metadados dela. Informe no corpo o id da pasta e o novo title. labels e metadata, quando enviados, substituem inteiros os valores atuais; quando omitidos, os valores atuais são mantidos. A pasta continua no mesmo lugar: para trocá-la de pasta, use a rota de mover pasta. A resposta traz a pasta já alterada. id ou title ausentes, ou com tipo diferente de texto, devolvem 422 com a lista de erros, e metadata com chave diferente de name e value devolve 422 sem mensagem. Pasta inexistente devolve 500. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Pasta alterada

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Dados inválidos

🔴500Falha ao editar a pasta

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/documents/folders/edit' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "id": "Xk9pQ2mW7rLz4NvB8cYt1HdJ5sFg",
    "title": "Documentos da safra 2026/27"
}'

Response Example

200 - Sucesso

{
    "id": "Xk9pQ2mW7rLz4NvB8cYt1HdJ5sFg",
    "kind": "drive#folder",
    "labels": {
        "label": "Fazenda"
    },
    "parent": "root",
    "title": "Documentos da safra 2026/27",
    "metadata": [
        {
            "name": "safra",
            "value": "2026"
        }
    ]
}

Modificado em 2026-10-13 09:47:06

Página anterior

Listar conteúdo de uma pasta

Próxima página

Mover pasta