Skip to main content
GET
/
v3
/
projects
Listar projetos do usuário
curl --request GET \
  --url https://api.metrito.com/v3/projects \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "69162064162b926ae607959b",
    "name": "Minha Loja Online",
    "description": "E-commerce de roupas",
    "logo": "https://storage.metrito.com/logos/minhaloja.png",
    "workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1"
  },
  {
    "id": "69162064162b926ae607960c",
    "name": "SaaS App",
    "description": null,
    "logo": null,
    "workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1"
  }
]

Autenticação

Este endpoint aceita dois formatos de autenticação:
  1. JWT da plataforma
    • Header: Authorization: Bearer {jwt}
  2. API Key do Metrito
    • Header: Authorization: Bearer mtk_live_... ou x-api-key: mtk_live_...
    • Requer escopo data:read
    • Retorna todos os projetos do workspace vinculado à chave

Authorizations

Authorization
string
header
required

JWT da plataforma ou API key mtk_live_... enviada no header Authorization

Response

Lista de projetos retornada com sucesso

id
string

ID do projeto (usar como project_id nas demais APIs)

name
string

Nome do projeto

description
string | null

Descrição do projeto

logo
string | null

URL do logo do projeto

workspace_id
string

ID do workspace ao qual o projeto pertence