Página de status

A página de status é uma página pública da sua organização para os seus clientes: mostra os componentes do seu serviço, o estado de cada um, os incidentes e as manutenções que você publicou. Ela é opcional, não exige login e continua no ar mesmo com o portal da plataforma fora.

Diferença para o status da plataforma

	Status da plataforma	Sua página de status
Endereço	status.<domínio da plataforma>	<slug>.status-pages.<domínio da plataforma> ou o seu domínio
Conteúdo	só os serviços da plataforma	só o que você publicou
Responsável	Coda Cloud	a sua organização

O domínio-base das páginas de tenants é diferente do status da plataforma, para que nenhuma página pareça oficial da plataforma. A página identifica a sua organização como responsável pelo conteúdo e mostra "Hospedado na Coda Cloud" apenas como crédito no rodapé. Uma queda sua nunca aparece no status da plataforma.

Criar e publicar

Owner e Admin da organização criam páginas com:

• slug único na plataforma (3 a 40 caracteres, letras minúsculas, dígitos e hífens). Slugs de uso da plataforma, como www, status, admin e api, são reservados (400 status_page.slug_reserved); um slug já usado por outra organização responde 409 status_page.slug_taken, sem revelar quem o usa;
• título, descrição, tema (claro ou escuro) e idioma (pt-BR ou en-US);
• logotipo PNG ou WebP de até 256 KB e 512 × 512 px. A plataforma reprocessa o arquivo (remove metadados como EXIF e GPS) e o serve do próprio endereço da página.

A página nasce como rascunho e só responde publicamente depois de publicada; despublicar volta ao rascunho (o endereço responde 404).

Componentes

Cada componente (agrupável) tem um status entre operational, degraded, partial_outage, major_outage e maintenance:

• ligado a monitores (veja Monitores de disponibilidade): o pior estado entre eles — todos DOWN é major_outage, só parte DOWN é partial_outage, DEGRADED é degraded e MAINTENANCE é maintenance; a página reflete uma queda em até 60 segundos;
• manual: o status que você definir, até a próxima alteração.

Cada componente tem barras diárias de uptime dos últimos 90 dias, calculadas pelo SLA diário dos monitores ligados. Um monitor que não está ligado a nenhum componente nunca aparece: nomes de monitores, alvos, locais das sondas e motivos técnicos de falha não são publicados.

Para ligar um componente a um monitor, você precisa ter acesso ao projeto do monitor.

Incidentes e manutenções

Você publica incidentes com título, impacto (none, minor, major ou critical), componentes afetados e atualizações sucessivas (investigating, identified, monitoring, resolved), cada uma com horário. Incidentes dos monitores não são publicados sozinhos: no portal, "Publicar incidente" a partir de um incidente de monitor traz o formulário pré-preenchido para você decidir o texto.

O texto aceita um subconjunto seguro de Markdown (ênfase, listas e links https: ou mailto:). HTML e scripts aparecem como texto escapado e links de outros esquemas (como javascript:) perdem o link.

As janelas de manutenção marcadas para publicação aparecem em "Manutenções programadas", com a próxima ocorrência e o fuso indicado.

Domínio próprio

Com a chave statusPages.customDomain no seu plano, a página pode responder num domínio seu (por exemplo status.acme.com):

1. associe o domínio à página;
2. publique o registro TXT _atlas-challenge.<domínio> com o valor mostrado (o mesmo verificador de Domínios e TLS, com prazo de 72 horas);
3. aponte um CNAME do domínio para <slug>.status-pages.<domínio da plataforma>;
4. acione Verificar. Verificado, a plataforma emite o certificado e o domínio passa a servir a página publicada.

Um domínio verificado pertence a uma única organização, valendo junto com os domínios das aplicações: outro tenant que tente o mesmo domínio recebe 409. Sem a chave no plano, a associação responde 403 plan.feature_unavailable. Ao mudar para um plano sem a chave, o domínio sai do ar, mas a configuração e a verificação ficam guardadas.

Feeds e dados públicos

Cada página publicada oferece:

• /feed.atom — feed Atom dos incidentes e manutenções dos últimos 90 dias;
• /summary.json — resumo versionado (atlas.statuspage/v1) com o status geral (indicator: none, minor, major ou maintenance), os componentes, os incidentes abertos e as manutenções futuras.

Exemplo de summary.json:

{
  "version": "atlas.statuspage/v1",
  "page": { "name": "Acme", "url": "https://acme.status-pages.atlas.example.com", "updatedAt": "2026-10-22T12:00:00Z" },
  "status": { "indicator": "minor", "description": "Partial outage" },
  "components": [{ "name": "Loja", "status": "partial_outage", "group": null }],
  "incidents": [
    {
      "title": "Lentidão no checkout",
      "impact": "minor",
      "status": "investigating",
      "startedAt": "2026-10-22T11:40:00Z",
      "updatedAt": "2026-10-22T11:45:00Z"
    }
  ],
  "scheduledMaintenances": []
}

Privacidade e desempenho

A página e os feeds não usam cookies, scripts de terceiros nem rastreamento, e a política de conteúdo só permite recursos da própria página. As respostas ficam em cache por 30 segundos, e cada IP pode fazer até 120 requisições por minuto (acima disso, 429).

Planos e permissões

Chave	O que limita	Ao estourar
statusPages.maxPages	páginas da organização	422 quota-exceeded ao criar; num plano menor, as páginas excedentes mais recentes são despublicadas (sem exclusão)
statusPages.customDomain	domínio próprio	403 plan.feature_unavailable

Todo membro lê as páginas no portal; criar, editar, publicar, gerenciar componentes, incidentes e domínio exige Admin ou Owner da organização. Tokens de API usam os escopos status-pages:read e status-pages:write (veja Planos e limites e Tokens de API).