Criar pasta nos documentos de um cliente

POST

/documents/folders/

Cria uma pasta nos documentos do cliente informado em clientId. Para criar a pasta no primeiro nível dos documentos do cliente, envie parent com o valor root; para criá-la dentro de outra pasta, envie em parent o id dessa pasta. A pasta pode receber etiquetas (labels) e metadados (metadata), uma lista de pares name e value. A resposta traz o id da pasta criada, que é usado nas demais rotas de pastas e como parent de arquivos e subpastas. Campos obrigatórios ausentes, ou enviados com tipo diferente de texto, devolvem 422 com a lista de erros. metadata com chave diferente de name e value devolve 422 sem mensagem, e cliente inexistente devolve 422 (ClientId é vazio!). 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

🟢201

application/json

Pasta criada

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Dados inválidos

Request Example

Shell

JavaScript

Java

Swift

curl --location '/documents/folders/' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "title": "Documentos da safra 2026",
    "parent": "root",
    "clientId": "3f1c2a9e-5b7d-4e8a-9c0f-1a2b3c4d5e6f",
    "metadata": [
        {
            "name": "safra",
            "value": "2026"
        }
    ]
}'

Response Example

201 - Sucesso

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

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

Página anterior

Remover compartilhamento de arquivo

Próxima página

Listar conteúdo de uma pasta