Listar Projetos
GET/external/v1/projectsRetorna os projetos do CRM da sua conta: os grupos em que os pipelines são organizados. Use para resolver o project_id que Listar pipelines devolve, ou como valor do filtro project_id de lá.
Autenticação
Requer permissão projects:read.
Parâmetros de Query
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
is_active | boolean | - | true retorna só os projetos ativos, false só os inativos |
Requisição
bash
curl --request GET \
--url "https://app.getraze.com/external/v1/projects" \
--header "X-API-Key: YOUR_API_KEY"javascript
const axios = require('axios');
const response = await axios.get('https://app.getraze.com/external/v1/projects', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(response.data);python
import requests
response = requests.get(
'https://app.getraze.com/external/v1/projects',
headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(response.json())Resposta
json
{
"success": true,
"data": [
{
"id": "proj_01",
"name": "CRM",
"description": null,
"color": "blue",
"is_active": true,
"display_order": 0,
"created_at": "2026-01-10T08:00:00Z",
"updated_at": "2026-01-10T08:00:00Z"
}
]
}Campos de Resposta
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Identificador do projeto (o project_id dos pipelines) |
name | string | Nome do projeto |
description | string | Descrição opcional (nullable) |
color | string | Dica de apresentação para UI |
is_active | boolean | Se o projeto está ativo |
display_order | integer | Ordenação do projeto |