API-Referenz

Team

Team-Mitglieder und ihre Rollen

Team-Mitglieder

GET/v1/team

Scope read:teamRecht: Leads einsehenliest

Alle Personen im Konto mit Rolle, sortiert nach Name. Die id ist der Wert für assigned_user_id an Leads. Wer Leads sieht, sieht wie in der App die Kollegen im Feld „Zuständig“. E-Mail und letzter Login kommen nur mit, wenn die Person, die den Key erzeugt hat, das Recht settings.team (Team-Verwaltung) hat, wie auf der Team-Seite der App. Offene Einladungen, Rechte und Konto-Zuweisungen gibt die API nicht heraus.

Query-Parameter

limitintegerab 1bis 100
Einträge pro Seite (Standard 25, höchstens 100)
cursorstringmax. 200 Zeichen
Wert aus meta.next_cursor der vorigen Seite

Felder der Antwort

idstring (uuid)
ID der Person, z. B. für assigned_user_id an Leads
full_namestring, kann null sein
Anzeigename aus dem Profil, null, wenn nicht gepflegt
first_namestring, kann null sein
Vorname aus dem Profil, null, wenn nicht gepflegt
last_namestring, kann null sein
Nachname aus dem Profil, null, wenn nicht gepflegt
avatar_urlstring, kann null sein
URL des Profilbilds, null ohne Bild
rolestring
tenant_owner: Inhaber, tenant_admin: Admin, tenant_user: Mitglied mit einzeln vergebenen Rechten
tenant_owner tenant_admin tenant_user
created_atstring (date-time), kann null sein
Im Team seit
emailstring (email), kann null seinmax. 320 Zeichen
Nur wenn die Person, die den Key erzeugt hat, das Recht settings.team (Team-Verwaltung) hat. Sonst fehlt das Feld.
last_sign_in_atstring (date-time), kann null sein
Letzter Login. Nur mit settings.team, sonst fehlt das Feld.

Mögliche Fehler

400 VALIDATION_ERROR401 INVALID_API_KEY402 PLAN_REQUIRED403 SCOPE_MISSING429 RATE_LIMITED

curl -X GET "https://api.dealsky.io/functions/v1/api/v1/team" \
  -H "X-API-Key: $DEALSKY_API_KEY"

const res = await fetch("https://api.dealsky.io/functions/v1/api/v1/team", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.DEALSKY_API_KEY,
  },
});
const { ok, data, error } = await res.json();

import os, requests

res = requests.request(
    "GET",
    "https://api.dealsky.io/functions/v1/api/v1/team",
    headers={"X-API-Key": os.environ["DEALSKY_API_KEY"]},
)
print(res.json())

Antwort 200

{
  "ok": true,
  "data": [
    {
      "id": "a3a3a3a3-a3a3-4a3a-8a3a-a3a3a3a3a3a3",
      "full_name": "Anna Beispiel",
      "first_name": "Anna",
      "last_name": "Beispiel",
      "avatar_url": "https://imagedelivery.net/beispiel/avatar/public",
      "role": "tenant_admin",
      "created_at": "2026-03-02T10:00:00.000Z"
    }
  ],
  "meta": {
    "request_id": "req_7f3a…",
    "next_cursor": null,
    "has_more": false
  }
}