// API docs

API documentation

Everything you need to integrate with Tarello features. Start at "Getting started" or jump straight to the feature you will use.

API v1 (current)

A API atual da Tarello é a v1. Esta é a única versão suportada para integração nova.

URL base

https://api.tarello.io/v1

Compromissos da v1

  • Estabilidade de contrato: campos não serão removidos nem renomeados sem aviso prévio de pelo menos 6 meses.
  • Aditivos compatíveis: novos campos podem ser adicionados a qualquer momento. Seu cliente deve ignorar campos desconhecidos.
  • Deprecação: quando um endpoint for descontinuado, você verá o header Deprecation: true e um link no Sunset indicando a data limite.

Versionamento de mudanças incompatíveis

Mudanças que quebram contrato exigem nova versão major (v2). A v1 continuará operando por pelo menos 12 meses após o lançamento da v2.

Como acompanhar

Veja o Changelog da API e assine notificações de versão no Console em Notificações → API.