Zum Inhalt springen

API-Referenz

  • OpenAPI 3.1
  • Version 2026-11-01
  • 42 Operationen
  • curl · TypeScript · Python
Try it

Codebeispiele

Jedes Beispiel läuft in der CI der SDKs gegen die Sandbox.
curl -X POST https://api.bodo-app.com/v1/contacts \
  -H "Authorization: Bearer $BODO_API_KEY" \
  -H "Bodo-Preview: true" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Erika","lastName":"Mustermann","email":"erika@musterfirma.de"}'
Referenz wird geladen

Alle Operationen

Preview-Operationen brauchen Bodo-Preview: true, sonst antwortet die API mit 404 OPERATION_NOT_IN_VERSION. Preview ist keine Produktionsgrundlage.
MethodePfadOperationKanalScopeKosten
GET/v1/meWer bin ich?Stable—1 Punkt
GET/v1/rate_limitStand der LimitsStable—1 Punkt
GET/v1/openapi.jsonDie OpenAPI-SpecStable—1 Punkt
GET/v1/contactsKontakte auflistenStablecontacts:read2 Punkte
POST/v1/contactsKontakt anlegenPreviewcontacts:write5 Punkte
GET/v1/contacts/countKontakte zählenStablecontacts:read2 Punkte
GET/v1/contacts/{id}Kontakt lesenStablecontacts:read1 Punkt
PATCH/v1/contacts/{id}Kontakt ändernPreviewcontacts:write5 Punkte
DELETE/v1/contacts/{id}Kontakt löschenPreviewcontacts:write10 Punkte
GET/v1/companiesFirmen auflistenStablecompanies:read2 Punkte
POST/v1/companiesFirma anlegenPreviewcompanies:write5 Punkte
GET/v1/companies/countFirmen zählenStablecompanies:read2 Punkte
GET/v1/companies/{id}Firma lesenStablecompanies:read1 Punkt
PATCH/v1/companies/{id}Firma ändernPreviewcompanies:write5 Punkte
DELETE/v1/companies/{id}Firma löschenPreviewcompanies:write10 Punkte
GET/v1/tasksAufgaben auflistenStabletasks:read2 Punkte
POST/v1/tasksAufgabe anlegenPreviewtasks:write5 Punkte
GET/v1/tasks/countAufgaben zählenStabletasks:read2 Punkte
GET/v1/tasks/{id}Aufgabe lesenStabletasks:read1 Punkt
PATCH/v1/tasks/{id}Aufgabe ändernPreviewtasks:write5 Punkte
DELETE/v1/tasks/{id}Aufgabe löschenPreviewtasks:write10 Punkte
POST/v1/tasks/{id}/completeAufgabe erledigenPreviewtasks:write5 Punkte
GET/v1/documentsDokumente auflistenStabledocuments:read2 Punkte
POST/v1/documentsDokument aus einem Upload anlegenPreviewdocuments:write10 Punkte
GET/v1/documents/countDokumente zählenStabledocuments:read2 Punkte
GET/v1/documents/{id}Dokument lesenStabledocuments:read1 Punkt
PATCH/v1/documents/{id}Dokument ändernPreviewdocuments:write5 Punkte
DELETE/v1/documents/{id}Dokument löschenPreviewdocuments:write10 Punkte
GET/v1/documents/{id}/contentDatei herunterladenStabledocuments:read1 Punkt
POST/v1/uploadsUpload-Sitzung anlegenPreviewdocuments:write5 Punkte
POST/v1/batchMehrere Aufrufe bündelnPreview—0 Punkte
GET/v1/operations/{id}Operation abfragenStable—1 Punkt
GET/v1/webhook_endpointsWebhook-Endpunkte auflistenStablewebhook_endpoints:read2 Punkte
POST/v1/webhook_endpointsWebhook-Endpunkt anlegenPreviewwebhook_endpoints:write5 Punkte
GET/v1/webhook_endpoints/{id}Webhook-Endpunkt lesenStablewebhook_endpoints:read1 Punkt
PATCH/v1/webhook_endpoints/{id}Webhook-Endpunkt ändernPreviewwebhook_endpoints:write5 Punkte
DELETE/v1/webhook_endpoints/{id}Webhook-Endpunkt löschenPreviewwebhook_endpoints:write10 Punkte
POST/v1/webhook_endpoints/{id}/testTest-Ereignis sendenPreviewwebhook_endpoints:write5 Punkte
POST/v1/webhook_endpoints/{id}/rotate_secretSignier-Secret drehenPreviewwebhook_endpoints:write5 Punkte
GET/v1/webhook_endpoints/{id}/deliveriesZustell-Log lesenStablewebhook_endpoints:read2 Punkte
GET/v1/eventsEreignisse auflistenStable—1 Punkt
GET/v1/events/{id}Ereignis lesenStable—1 Punkt

Spec und Try-it