Skip to main content
GET
curl
Lista uma pasta do projeto, como a aba Arquivos do painel. Com path vazio, a raiz. Permissão da chave: files:read (Chaves de API).

Erros comuns

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization
string
header
obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_…. Cada rota pede uma permissão da chave (o escopo no security da rota, como files:write); sem ela, 403 insufficient_scope com o requiredScope. Veja Chaves de API.

Parâmetros de caminho

id
string
obrigatório

O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em GET /projects.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
Exemplo:

"01J8Z3W6N0Q4Y7V2K5T9D1H3XA"

Parâmetros de consulta

path
string

A pasta, relativa à raiz (vazio = a raiz).

Maximum string length: 4096

Resposta

A pasta.

path
string
obrigatório
items
object[]
obrigatório
isTruncated
boolean
obrigatório
isProtected
boolean