HR & Mitarbeiter – Flowtly Developer-Plattform

Entitätsüberblick

Mitarbeiter

Lege Mitarbeitende für Zuweisungen, Freigaben und Zugriffe an und verwalte sie.

Endpoints

GET https://api.flowtly.eu/employees

Mitarbeiter auflisten

Rufe Mitarbeiterprofile mit Paginierung und Filtern ab.

POST https://api.flowtly.eu/employees

Mitarbeiter erstellen

Füge einen Mitarbeiter mit Name, E-Mail und optionalem Avatar hinzu.

GET https://api.flowtly.eu/employees/me

Mich auflisten

Ruft die Sammlung von Mitarbeiter-Ressourcen ab.

GET https://api.flowtly.eu/employees/preview

Vorschau auflisten

Ruft die Sammlung von Mitarbeiter-Ressourcen ab.

GET https://api.flowtly.eu/employees/search

Suche auflisten

Ruft die Sammlung von Mitarbeiter-Ressourcen ab.

GET https://api.flowtly.eu/employees/{id}

Mitarbeiter per ID abrufen

Liest ein konkretes Mitarbeiterprofil.

DELETE https://api.flowtly.eu/employees/{id}

Mitarbeiter löschen

Entfernt ein Mitarbeiterprofil.

PATCH https://api.flowtly.eu/employees/{id}

Mitarbeiter aktualisieren

Passe Mitarbeiterdetails wie Name oder E-Mail an.

GET https://api.flowtly.eu/employees/{id}/documents

Mitarbeiter per ID abrufen

Liest ein konkretes Mitarbeiterprofil.

GET https://api.flowtly.eu/employees/{id}/feedback-suggestion

Mitarbeiter per ID abrufen

Liest ein konkretes Mitarbeiterprofil.

GET https://api.flowtly.eu/employees/{id}/project-rates

Mitarbeiter per ID abrufen

Liest ein konkretes Mitarbeiterprofil.

POST https://api.flowtly.eu/employees/{id}/user

Erstellt eine Mitarbeiter-Ressource.

Erstellt eine Mitarbeiter-Ressource.

DELETE https://api.flowtly.eu/employees/{id}/user

Mitarbeiter löschen

Entfernt ein Mitarbeiterprofil.

GET https://api.flowtly.eu/employees/{id}/working-hours-stats/{date}

Mitarbeiter per ID abrufen

Liest ein konkretes Mitarbeiterprofil.

Anwendungsfälle

Neue Mitarbeiter aus Ihrem HRIS bereitstellen, damit sie am ersten Tag in Flowtly erscheinen.

Organigramm-Änderungen synchronisieren, um Projektbesetzungen und Genehmigungsketten aktuell zu halten.

Schemafelder

Employee-employee.read_employee.detail

Feld	Typ	Beschreibung
id	integer	Interne Mitarbeiter-ID.
userId	integer	Feld userId.
companyEmail	string	Feld companyEmail.
contactEmail	string	Feld contactEmail.
contactPhone	string	Feld contactPhone.
birthday	string	Feld birthday.
firstname	string	Vorname des Mitarbeiters.
lastname	string	Nachname des Mitarbeiters.
roles	array	Feld roles.
phoneTextAllowed	boolean	Feld phoneTextAllowed.
department	string	Feld department.
reportsTo	string	Feld reportsTo.
directReports	array	Feld directReports.
departments	array	Feld departments.
activeAgreement	string	Feld activeAgreement.

Entitätsüberblick

Abteilung

Verwalten Sie die Abteilungshierarchie, um die Zugriffskontrolle, Budgetzuweisung und Personalberichterstattung zu steuern.

Endpoints

GET https://api.flowtly.eu/departments

Abteilungen auflisten

Ruft die Sammlung von Abteilungsressourcen ab.

POST https://api.flowtly.eu/departments

Abteilung erstellen

Erstellt eine Abteilungsressource.

GET https://api.flowtly.eu/departments/{id}

Abteilung nach ID abrufen

Ruft eine einzelne Ressource anhand ihres Identifikators ab.

PATCH https://api.flowtly.eu/departments/{id}

Abteilung aktualisieren

Aktualisiert Ressourcenfelder mithilfe von JSON Merge Patch.

Anwendungsfälle

Spiegeln Sie Ihre HRIS-Abteilungsstruktur in Flowtly für eine einheitliche Organisationsberichterstattung.

Erstellen Sie Abteilungen, um Budget- und Auslastungs-Dashboards zu segmentieren.

Schemafelder

Department-department.read_employee.preview

Feld	Typ	Beschreibung
id	integer	ID-Feld.
name	string	Name-Feld.
code	string | null	Code-Feld.
manager	object	Manager-Feld.

Entitätsüberblick

Position

Standardisierte Positionen definieren, um rollenbasierte Zuweisungen, Vertrags-Templates und Personalbedarfsplanung voranzutreiben.

Endpoints

GET https://api.flowtly.eu/positions

Positionen auflisten

Ruft die Sammlung von Position-Ressourcen ab.

POST https://api.flowtly.eu/positions

Position erstellen

Erstellt eine Position-Ressource.

GET https://api.flowtly.eu/positions/{id}

Position nach ID abrufen

Ruft eine einzelne Ressource anhand ihrer Kennung ab.

DELETE https://api.flowtly.eu/positions/{id}

Position löschen

Entfernt die Ressource.

PATCH https://api.flowtly.eu/positions/{id}

Position aktualisieren

Ressourcenfelder mithilfe von JSON Merge Patch aktualisieren.

Anwendungsfälle

Synchronisieren Sie offene Positionen von Ihrem ATS, um die Einstellungspipeline in Flowtly zu verfolgen.

Ordnen Sie Positionen Kostenraten für automatisierte Projektrentabilitätsberechnungen zu.

Schemafelder

Position-position.read_responsibility.read

Feld	Typ	Beschreibung
id	string	ID-Feld.
name	string	Name-Feld.
roles	array	Rollen-Feld.
responsibilities	object	Zuständigkeiten-Feld.

Entitätsüberblick

Leistung

Verwalten Sie den Leistungskatalog, die Preise und die Mitarbeiterregistrierung, um HR-Vergütungsdaten synchron zu halten.

Endpoints

GET https://api.flowtly.eu/benefits

Leistungen auflisten

Ruft die Sammlung der EmployeeBenefit-Ressourcen ab.

POST https://api.flowtly.eu/benefits

Leistung erstellen

Erstellt eine EmployeeBenefit-Ressource.

GET https://api.flowtly.eu/benefits/{id}

Leistung nach ID abrufen

Ruft eine einzelne Ressource anhand ihrer Kennung ab.

PATCH https://api.flowtly.eu/benefits/{id}

Leistung aktualisieren

Aktualisiert Ressourcenfelder mithilfe von JSON Merge Patch.

POST https://api.flowtly.eu/benefit-prices

Leistung erstellen

Erstellt eine EmployeeBenefit-Ressource.

GET https://api.flowtly.eu/benefit-prices/{id}

Leistung nach ID abrufen

Ruft eine einzelne Ressource anhand ihrer Kennung ab.

DELETE https://api.flowtly.eu/benefit-prices/{id}

Leistung löschen

Entfernt die Ressource.

PATCH https://api.flowtly.eu/benefit-prices/{id}

Leistung aktualisieren

Aktualisiert Ressourcenfelder mithilfe von JSON Merge Patch.

GET https://api.flowtly.eu/employee-benefits

Leistungen auflisten

Ruft die Sammlung der EmployeeBenefit-Ressourcen ab.

POST https://api.flowtly.eu/employee-benefits

Leistung erstellen

Erstellt eine EmployeeBenefit-Ressource.

GET https://api.flowtly.eu/employee-benefits/{id}

Leistung nach ID abrufen

Ruft eine einzelne Ressource anhand ihrer Kennung ab.

PATCH https://api.flowtly.eu/employee-benefits/{id}

Leistung aktualisieren

Aktualisiert Ressourcenfelder mithilfe von JSON Merge Patch.

Anwendungsfälle

Leistungspläne von Ihrem Makler importieren und berechtigte Mitarbeiter automatisch anmelden.

Leistungskosten pro Mitarbeiter für die Gesamtvergütungsberichterstattung verfolgen.

Schemafelder

BenefitPrice-benefit.read_benefit_price.read

Feld	Typ	Beschreibung
id	integer	id Feld.
validFrom	string	validFrom Feld.
validTo	string | null	validTo Feld.
price	number	price Feld.
taxPercent	number	taxPercent Feld.
defaultCompanyCoverageAmount	number	defaultCompanyCoverageAmount Feld.

Entitätsüberblick

Mitarbeiter-Notiz

HR-Notizen für Leistungsbeurteilungen, Onboarding-Status und interne Memos speichern und abrufen.

Endpoints

GET https://api.flowtly.eu/employee-notes

Mitarbeiter-Notizen auflisten

Ruft die Sammlung von EmployeeNote-Ressourcen ab.

POST https://api.flowtly.eu/employee-notes

Mitarbeiter-Notiz erstellen

Erstellt eine EmployeeNote-Ressource.

GET https://api.flowtly.eu/employee-notes/{id}

Mitarbeiter-Notiz per ID abrufen

Ruft eine einzelne Ressource anhand ihrer Kennung ab.

DELETE https://api.flowtly.eu/employee-notes/{id}

Mitarbeiter-Notiz löschen

Ressource entfernen.

PATCH https://api.flowtly.eu/employee-notes/{id}

Mitarbeiter-Notiz aktualisieren

Aktualisiert Ressourcenfelder mithilfe von JSON Merge Patch.

Anwendungsfälle

Manager-Feedback aus Ihrem 1:1-Tool in Flowtly-Mitarbeiterdatensätze übertragen.

Compliance- oder Hintergrundprüfungsnotizen an Mitarbeiterprofile anhängen.

Schemafelder

EmployeeNote-employee_note.read

Feld	Typ	Beschreibung
id	string	Feld id.
employee	string	Feld employee.
author	string	Feld author.
note	string	Feld note.
createdAt	string	Feld createdAt.

Entitätsüberblick

Mitarbeiter-Arbeitsschutz

Obligatorische OHS (BHP) Schulungszertifizierungen, Ablaufdaten und Konformitätsstatus verfolgen.

Endpoints

GET https://api.flowtly.eu/employee-bhps

Mitarbeiter-Arbeitsschutz auflisten

Ruft die Sammlung von EmployeeBhp Ressourcen ab.

POST https://api.flowtly.eu/employee-bhps

Mitarbeiter-Arbeitsschutz erstellen

Erstellt eine EmployeeBhp-Ressource.

GET https://api.flowtly.eu/employee-bhps/{id}

Mitarbeiter-Arbeitsschutz per ID abrufen

Ruft eine einzelne Ressource anhand ihrer Kennung ab.

PATCH https://api.flowtly.eu/employee-bhps/{id}

Mitarbeiter-Arbeitsschutz aktualisieren

Aktualisiert Ressourcenfelder mithilfe von JSON Merge Patch.

Anwendungsfälle

Arbeitsschutzschulungs-Abschlüsse von Ihrem LMS mit Flowtly synchronisieren.

Manager benachrichtigen, wenn die OHS-Zertifizierung eines Mitarbeiters abläuft.

Schemafelder

EmployeeBhp-employee_bhp.read

Feld	Typ	Beschreibung
id	integer	Feld id.
employee	string | null	Feld employee.
dateFrom	string	Feld dateFrom.
dateTo	string | null	Feld dateTo.
note	string | null	Feld note.

Entitätsüberblick

Verantwortlichkeit

Verantwortlichkeiten definieren, gruppieren und Mitarbeitern oder Positionen für eine strukturierte Verantwortlichkeit zuweisen.

Endpoints

GET https://api.flowtly.eu/position-responsibilities

Verantwortlichkeiten auflisten

Ruft die Sammlung von ResponsibilityGroup-Ressourcen ab.

POST https://api.flowtly.eu/position-responsibilities

Verantwortlichkeit erstellen

Erstellt eine ResponsibilityGroup-Ressource.

GET https://api.flowtly.eu/position-responsibilities/{id}

Verantwortlichkeit nach ID abrufen

Eine einzelne Ressource anhand ihrer Kennung abrufen.

DELETE https://api.flowtly.eu/position-responsibilities/{id}

Verantwortlichkeit löschen

Ressource entfernen.

GET https://api.flowtly.eu/responsibilities

Verantwortlichkeiten auflisten

Ruft die Sammlung von ResponsibilityGroup-Ressourcen ab.

POST https://api.flowtly.eu/responsibilities

Verantwortlichkeit erstellen

Erstellt eine ResponsibilityGroup-Ressource.

GET https://api.flowtly.eu/responsibilities/{id}

Verantwortlichkeit nach ID abrufen

Eine einzelne Ressource anhand ihrer Kennung abrufen.

PATCH https://api.flowtly.eu/responsibilities/{id}

Verantwortlichkeit aktualisieren

Ressourcenfelder mittels JSON Merge Patch aktualisieren.

GET https://api.flowtly.eu/responsibility-employees

Verantwortlichkeiten auflisten

Ruft die Sammlung von ResponsibilityGroup-Ressourcen ab.

POST https://api.flowtly.eu/responsibility-employees

Verantwortlichkeit erstellen

Erstellt eine ResponsibilityGroup-Ressource.

GET https://api.flowtly.eu/responsibility-employees/{id}

Verantwortlichkeit nach ID abrufen

Eine einzelne Ressource anhand ihrer Kennung abrufen.

DELETE https://api.flowtly.eu/responsibility-employees/{id}

Verantwortlichkeit löschen

Ressource entfernen.

PATCH https://api.flowtly.eu/responsibility-employees/{id}

Verantwortlichkeit aktualisieren

Ressourcenfelder mittels JSON Merge Patch aktualisieren.

GET https://api.flowtly.eu/responsibility-groups

Verantwortlichkeiten auflisten

Ruft die Sammlung von ResponsibilityGroup-Ressourcen ab.

POST https://api.flowtly.eu/responsibility-groups

Verantwortlichkeit erstellen

Erstellt eine ResponsibilityGroup-Ressource.

GET https://api.flowtly.eu/responsibility-groups/{id}

Verantwortlichkeit nach ID abrufen

Eine einzelne Ressource anhand ihrer Kennung abrufen.

PATCH https://api.flowtly.eu/responsibility-groups/{id}

Verantwortlichkeit aktualisieren

Ressourcenfelder mittels JSON Merge Patch aktualisieren.

Anwendungsfälle

Compliance-Pflichten Rollen zuordnen, damit Audit-Tools die Abdeckung überprüfen können.

Eine RACI-Matrix erstellen, indem Verantwortlichkeiten mit Ihrem Projektmanagement-Tool synchronisiert werden.

Schemafelder

Responsibility-responsibility.read_responsibility_employee.read

Feld	Typ	Beschreibung
id	integer	Feld 'id'.
parent	object	Feld 'parent'.
responsibilityGroup	string	Feld 'responsibilityGroup'.
name	string	Feld 'name'.
description	string	Feld 'description'.
children	array	Feld 'children'.
responsibilityEmployees	array	Feld 'responsibilityEmployees'.

Entitätsüberblick

Feedback

Peer- und Manager-Feedback für Leistungszyklen sammeln, verwalten und abfragen.

Endpoints

GET https://api.flowtly.eu/feedback

Feedbacks auflisten

Ruft die Sammlung von FeedbackRequest-Ressourcen ab.

POST https://api.flowtly.eu/feedback

Feedback erstellen

Erstellt eine FeedbackRequest-Ressource.

GET https://api.flowtly.eu/feedback/{id}

Feedback nach ID abrufen

Eine einzelne Ressource anhand ihrer Kennung abrufen.

GET https://api.flowtly.eu/feedback-requests

Feedbacks auflisten

Ruft die Sammlung von FeedbackRequest-Ressourcen ab.

POST https://api.flowtly.eu/feedback-requests

Feedback erstellen

Erstellt eine FeedbackRequest-Ressource.

GET https://api.flowtly.eu/feedback-requests/{id}

Feedback nach ID abrufen

Eine einzelne Ressource anhand ihrer Kennung abrufen.

Anwendungsfälle

Feedback-Anfragen von Ihrer Leistungsmanagement-Plattform auslösen.

Aggregierte Feedback-Bewertungen in Talent-Dashboards ziehen.

Schemafelder

Feedback-feedback.read

Feld	Typ	Beschreibung
id	string	ID-Feld.
employee	string | null	Mitarbeiterfeld.
authorEmployee	string | null	authorEmployee-Feld.
description	string	Beschreibungsfeld.
details	string | null	Detailfeld.
visibility	string	Sichtbarkeitsfeld.
rate	string	Bewertungsfeld.
createdAt	string	createdAt-Feld.

Entitätsüberblick

Organisationsbenutzer

Verwalten, wer Zugriff auf den Flowtly-Arbeitsbereich hat, Einladungen senden und Benutzer entfernen.

Endpoints

GET https://api.flowtly.eu/organization-users

Organisationsbenutzer auflisten

Ruft die Sammlung von OrganizationUserInvitation-Ressourcen ab.

DELETE https://api.flowtly.eu/organization-users/{id}

Organisationsbenutzer löschen

Ressource entfernen.

GET https://api.flowtly.eu/organization-user-invitations

Organisationsbenutzer auflisten

Ruft die Sammlung von OrganizationUserInvitation-Ressourcen ab.

POST https://api.flowtly.eu/organization-user-invitations/{id}/accept

Erstellt eine OrganizationUserInvitation-Ressource.

Erstellt eine OrganizationUserInvitation-Ressource.

POST https://api.flowtly.eu/organization-user-invitations/{id}/reject

Erstellt eine OrganizationUserInvitation-Ressource.

Erstellt eine OrganizationUserInvitation-Ressource.

Anwendungsfälle

Neue Mitarbeiter automatisch einladen, wenn sie in Ihrem Identitätsanbieter bereitgestellt werden.

Zugriff widerrufen, wenn Mitarbeiter aus Ihrem HRIS abgemeldet werden.

Schemafelder

OrganizationUser-organization_user.read_user.read

Feld	Typ	Beschreibung
id	string	Feld ID.
user	object	Benutzer-Feld.
type	string	Typ-Feld.