テナントごとのスキーマ API
Twenty に静的な API リファレンスはありません。 各ワークスペースには独自のスキーマがあり、カスタムオブジェクト（たとえばInvoice）を追加すると、Company や Person といった組み込みオブジェクトと同一の REST および GraphQL エンドポイントが即座に提供されます。 API はスキーマから生成されるため、エンドポイントはオブジェクト名やフィールド名を直接使用します — 不透明な ID はありません。
API キー作成後、Settings → API & Webhooks でワークスペース固有の API ドキュメントを利用できます。 実データに対して実際の呼び出しを実行できるインタラクティブなプレイグラウンドが含まれています。
2 種類の API
コア API —/rest/ と /graphql/
レコードに対する CRUD：People、Companies、Opportunities、およびカスタムオブジェクト。 クエリ、フィルター、リレーションのトラバース。
メタデータ API — /rest/metadata/ と /metadata/
スキーマ管理：オブジェクト、フィールド、リレーションの作成/変更/削除。 これは、プログラム的にデータモデルを変更する方法です。
どちらも REST と GraphQL で利用できます。 GraphQL では、バッチアップサートや、単一のクエリでリレーションをトラバースする機能が追加されています。 いずれの場合も、基盤となるデータは同じです。
ベース URL
| 環境 | ベース URL |
|---|---|
| クラウド | https://api.twenty.com/ |
| セルフホスト | https://{your-domain}/ |
認証
バッチ操作
REST と GraphQL はどちらも、1 リクエストあたり最大 60 レコードのバッチ処理（作成、更新、削除）に対応しています。 GraphQL は、CreateCompanies のような複数形の名前を使用して、バッチアップサート（1 回の呼び出しで作成または更新）もサポートします。
API レートリミット
| 制限 | 値 |
|---|---|
| リクエスト | 1 分あたり 100 回の呼び出し |
| バッチサイズ | 1 回の呼び出しあたり 60 レコード |