Aufgaben

Eine Aufgabe ist ein To-do, oft aus einem Meeting abgeleitet. Diese Endpunkte listen, durchsuchen, erstellen, ändern, erledigen und löschen Aufgaben.

Jeder Endpunkt unten zeigt in der Mitte seine Parameter und Antwortfelder und rechts ein Anfragebeispiel mit Beispielantwort.

Basis-URL https://api.sally.ioVersion v1.0 aktuell, noch nicht eingefrorenSo funktioniert die Versionierung

Listet die Aufgaben eines Unternehmenskontos auf (paginiert, optional gefiltert)

GET/v1.0/directories/{directoryId}/tasks

Der ?filter wählt eine Aufgabenansicht aus (Standard myTasks); die all*-Varianten sind nur für Admins/Owner verfügbar. Ein optionaler Teilstring in ?search wird mit dem Betreff der Aufgabe abgeglichen. Paginierung über ?page + ?pageSize (max. 100). Löse responsibleUserId/ownerId über GET /v1.0/directories/{directoryId}/memberships/users/{userId} auf.

Feldübersicht aus der Spezifikation

Felder der Antwort:

page / pageSize / total / hasMore: Paginierungsrahmen (aktuelle Seite, Seitengröße, Gesamtanzahl, ob weitere Seiten folgen).
items (array): die Aufgaben auf dieser Seite. Jeder Eintrag enthält:
- taskId (string): Id der Aufgabe.
- subject (string): Betreff der Aufgabe.
- description (string | null): Beschreibung der Aufgabe; null, wenn nicht gesetzt.
- ownerId (string): Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
- responsibleUserId (string | null): Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
- dueDate (string | null): Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
- isDone (boolean): ob die Aufgabe als erledigt markiert ist.
- doneOn (string | null): Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
- isCanceled (boolean): ob die Aufgabe abgebrochen ist.
- canceledOn (string | null): Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
- recordingSummaryId (string | null): Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
- appointmentId (string | null): Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
- createdOn (string): Erstellungszeitstempel (ISO 8601).
- modifiedOn (string): Zeitstempel der letzten Änderung (ISO 8601).

Pfadparameter

directoryIdstringPflicht
Id des Unternehmenskontos (des Sally-Firmenkontos), zu dem die Ressource gehört. Die Unternehmenskonten, die ein Token ansprechen kann, listet GET /v1.0/me/directories/memberships auf.

Query-Parameter

filterstringoptional
Benannte Voreinstellung, die Umfang und Status kombiniert. my… umfasst die Aufgaben des aufrufenden Nutzers, all… jede Aufgabe des Unternehmenskontos, die der Aufrufer sehen darf. Der Statusteil ist Tasks (beliebig), Open, Overdue, Completed oder Forwarded. Weggelassen bedeutet: kein Voreinstellungsfilter.
Erlaubte Werte: myTasksmyOpenmyOverduemyCompletedmyForwardedallTasksallOpenallOverdueallCompletedallForwarded
searchstringoptional
Teilstring-Suche im Betreff der Aufgabe ohne Beachtung der Groß- und Kleinschreibung. Der Suchbegriff darf am Anfang, in der Mitte oder am Ende stehen.
pagenumberoptional
Seitennummer, beginnend bei 1. Standard: 1.
pageSizenumberoptional
Einträge pro Seite. Standard: 25, maximal 100.
fieldsstringoptional
Kommagetrennte Liste der Felder, die zurückgegeben werden sollen. Lässt du den Parameter weg, bekommst du alle Felder, auch solche, die in Zukunft hinzukommen. Das ist deine Entscheidung: Nenne deine Felder explizit, wenn du davor geschützt sein willst.
Nur Felder der ersten Ebene können angegeben werden. Eine verschachtelte Liste wie attendees, tags oder sectionItems wird ganz oder gar nicht zurückgegeben; attendees.name wird nicht unterstützt.
Bei einer paginierten Antwort gilt die Auswahl für die Einträge in items; page, pageSize, total und hasMore werden immer zurückgegeben. Ein unbekannter Name wird mit 400 abgelehnt statt ignoriert.
Hier auswählbar: appointmentId, canceledOn, createdOn, description, doneOn, dueDate, isCanceled, isDone, modifiedOn, ownerId, recordingSummaryId, responsibleUserId, subject, taskId.
Beispiel: appointmentId,canceledOn

Antwort: je Eintrag in items

taskIdstringPflicht
Id der Aufgabe.
subjectstringPflicht
Betreff der Aufgabe.
descriptionstringPflichtkann null sein
Beschreibung der Aufgabe; null, wenn nicht gesetzt.
ownerIdstringPflicht
Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
responsibleUserIdstringPflichtkann null sein
Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
dueDatestringPflichtkann null sein
Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
isDonebooleanPflicht
Ob die Aufgabe als erledigt markiert ist.
doneOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
isCanceledbooleanPflicht
Ob die Aufgabe abgebrochen ist.
canceledOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
recordingSummaryIdstringPflichtkann null sein
Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
appointmentIdstringPflichtkann null sein
Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
createdOnstringPflicht
Erstellungszeitstempel (ISO 8601).
modifiedOnstringPflicht
Zeitstempel der letzten Änderung (ISO 8601).

Jede Seite trägt außerdem page, pageSize, total, hasMore.

Statuscodes

200Erfolg
400
Ungültige Anfrage (Validierungsfehler).
401
Fehlender oder ungültiger Bearer-Token.
404
Ressource nicht gefunden oder nicht zugänglich.
429
Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.
500
Interner Serverfehler.

Anfrage

cURL
JavaScript
Python

curl "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/tasks" \
  -H "Authorization: Bearer $SALLY_TOKEN"

const response = await fetch(`https://api.sally.io/v1.0/directories/${directoryId}/tasks`, {
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    f"https://api.sally.io/v1.0/directories/{directory_id}/tasks",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
)
data = response.json()

Beispielantwort 200 OK

{
  "page": 1,
  "pageSize": 25,
  "total": 137,
  "hasMore": true,
  "items": [
    {
      "taskId": "6ceba541-fa71-44c7-a7f7-644d56b1b85d",
      "subject": "Quarterly planning",
      "description": "string",
      "ownerId": "e51b6a79-43bf-494f-a264-6825f41b0fb5",
      "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
      "dueDate": "2026-09-24T09:30:00Z",
      "isDone": true,
      "doneOn": "2026-09-24T09:30:00Z",
      "isCanceled": true,
      "canceledOn": "2026-09-24T09:30:00Z",
      "recordingSummaryId": "731180f9-257a-46cf-a7e3-8ca508fb9c35",
      "appointmentId": "d4398f97-cd92-4d21-a6ec-4aab0a85441b",
      "createdOn": "2026-09-24T09:30:00Z",
      "modifiedOn": "2026-09-24T09:30:00Z"
    }
  ]
}

Erstellt eine Aufgabe

POST/v1.0/directories/{directoryId}/tasks

Erstellt eine Aufgabe. Der Aufrufer wird zum Owner.

Feldübersicht aus der Spezifikation

Body-Felder:

subject (string, Pflicht): Betreff der Aufgabe (1..1000 Zeichen).
description (string, optional): Beschreibung der Aufgabe (max. 4000 Zeichen); null für keine.
responsibleUserId (string, optional): Id des verantwortlichen Nutzers; null oder weggelassen lässt die Aufgabe unzugewiesen.
dueDate (string, optional): Fälligkeitsdatum als ISO 8601-String; null für kein Fälligkeitsdatum.

Pfadparameter

directoryIdstringPflicht
Id des Unternehmenskontos (des Sally-Firmenkontos), zu dem die Ressource gehört. Die Unternehmenskonten, die ein Token ansprechen kann, listet GET /v1.0/me/directories/memberships auf.

Query-Parameter

fieldsstringoptional
Kommagetrennte Liste der Felder, die zurückgegeben werden sollen. Lässt du den Parameter weg, bekommst du alle Felder, auch solche, die in Zukunft hinzukommen. Das ist deine Entscheidung: Nenne deine Felder explizit, wenn du davor geschützt sein willst.
Nur Felder der ersten Ebene können angegeben werden. Eine verschachtelte Liste wie attendees, tags oder sectionItems wird ganz oder gar nicht zurückgegeben; attendees.name wird nicht unterstützt.
Bei einer paginierten Antwort gilt die Auswahl für die Einträge in items; page, pageSize, total und hasMore werden immer zurückgegeben. Ein unbekannter Name wird mit 400 abgelehnt statt ignoriert.
Hier auswählbar: appointmentId, canceledOn, createdOn, description, doneOn, dueDate, isCanceled, isDone, modifiedOn, ownerId, recordingSummaryId, responsibleUserId, subject, taskId.
Beispiel: appointmentId,canceledOn

Request-Body application/json

subjectstringPflicht
Betreff der Aufgabe (1..1000 Zeichen).
descriptionstringoptionalkann null sein
Beschreibung der Aufgabe (max. 4000 Zeichen); null für keine.
responsibleUserIdstringoptionalkann null sein
Id des verantwortlichen Nutzers; null für nicht zugewiesen.
dueDatestringoptionalkann null sein
Fälligkeitsdatum als ISO 8601-String; null für kein Fälligkeitsdatum.

Antwort

taskIdstringPflicht
Id der Aufgabe.
subjectstringPflicht
Betreff der Aufgabe.
descriptionstringPflichtkann null sein
Beschreibung der Aufgabe; null, wenn nicht gesetzt.
ownerIdstringPflicht
Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
responsibleUserIdstringPflichtkann null sein
Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
dueDatestringPflichtkann null sein
Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
isDonebooleanPflicht
Ob die Aufgabe als erledigt markiert ist.
doneOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
isCanceledbooleanPflicht
Ob die Aufgabe abgebrochen ist.
canceledOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
recordingSummaryIdstringPflichtkann null sein
Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
appointmentIdstringPflichtkann null sein
Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
createdOnstringPflicht
Erstellungszeitstempel (ISO 8601).
modifiedOnstringPflicht
Zeitstempel der letzten Änderung (ISO 8601).

Statuscodes

200Erfolg
400
Ungültige Anfrage (Validierungsfehler).
401
Fehlender oder ungültiger Bearer-Token.
403
Verboten (unzureichende Berechtigungen).
404
Ressource nicht gefunden oder nicht zugänglich.
429
Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.
500
Interner Serverfehler.

Anfrage

cURL
JavaScript
Python

curl -X POST "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/tasks" \
  -H "Authorization: Bearer $SALLY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "subject": "Quarterly planning"
}'

const response = await fetch(`https://api.sally.io/v1.0/directories/${directoryId}/tasks`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "subject": "Quarterly planning"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    f"https://api.sally.io/v1.0/directories/{directory_id}/tasks",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
    json={
        "subject": "Quarterly planning",
    },
)
data = response.json()

Beispielantwort 200 OK

{
  "taskId": "6ceba541-fa71-44c7-a7f7-644d56b1b85d",
  "subject": "Quarterly planning",
  "description": "string",
  "ownerId": "e51b6a79-43bf-494f-a264-6825f41b0fb5",
  "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
  "dueDate": "2026-09-24T09:30:00Z",
  "isDone": true,
  "doneOn": "2026-09-24T09:30:00Z",
  "isCanceled": true,
  "canceledOn": "2026-09-24T09:30:00Z",
  "recordingSummaryId": "731180f9-257a-46cf-a7e3-8ca508fb9c35",
  "appointmentId": "d4398f97-cd92-4d21-a6ec-4aab0a85441b",
  "createdOn": "2026-09-24T09:30:00Z",
  "modifiedOn": "2026-09-24T09:30:00Z"
}

Durchsucht Aufgaben (Parameter im Body)

POST/v1.0/directories/{directoryId}/tasks/search

Durchsucht Aufgaben.

Feldübersicht aus der Spezifikation

Body-Felder:

search (string, optional): Teilstring über Betreff UND Beschreibung der Aufgabe, ohne Beachtung der Groß- und Kleinschreibung.
responsible (string, optional): Filter nach der Id des verantwortlichen Nutzers; deine eigene ist immer erlaubt, ein anderer Nutzer oder das Weglassen (= alle Verantwortlichen) erfordert Admin/Owner.
status (string, optional): einer von open (nicht erledigt/abgebrochen), completed, overdue (offen + überfällig), canceled; weglassen für jeden Status.
page (number, optional, Standard 1): Seitennummer, beginnend bei 1.
pageSize (number, optional, Standard 25): Seitengröße (max. 100).

Die Ergebnisse sind aufsteigend nach Fälligkeitsdatum sortiert.

Pfadparameter

directoryIdstringPflicht
Id des Unternehmenskontos (des Sally-Firmenkontos), zu dem die Ressource gehört. Die Unternehmenskonten, die ein Token ansprechen kann, listet GET /v1.0/me/directories/memberships auf.

Query-Parameter

fieldsstringoptional
Kommagetrennte Liste der Felder, die zurückgegeben werden sollen. Lässt du den Parameter weg, bekommst du alle Felder, auch solche, die in Zukunft hinzukommen. Das ist deine Entscheidung: Nenne deine Felder explizit, wenn du davor geschützt sein willst.
Nur Felder der ersten Ebene können angegeben werden. Eine verschachtelte Liste wie attendees, tags oder sectionItems wird ganz oder gar nicht zurückgegeben; attendees.name wird nicht unterstützt.
Bei einer paginierten Antwort gilt die Auswahl für die Einträge in items; page, pageSize, total und hasMore werden immer zurückgegeben. Ein unbekannter Name wird mit 400 abgelehnt statt ignoriert.
Hier auswählbar: appointmentId, canceledOn, createdOn, description, doneOn, dueDate, isCanceled, isDone, modifiedOn, ownerId, recordingSummaryId, responsibleUserId, subject, taskId.
Beispiel: appointmentId,canceledOn

Request-Body application/json

searchstringoptionalkann null sein
Teilstring-Suche im Betreff UND in der Beschreibung der Aufgabe ohne Beachtung der Groß- und Kleinschreibung. Der Suchbegriff darf am Anfang, in der Mitte oder am Ende stehen.
responsiblestringoptionalkann null sein
Filter nach der Id des verantwortlichen Nutzers. Deine eigene Id ist immer erlaubt; ein anderer Nutzer oder das Weglassen (= alle Verantwortlichen) erfordert Admin/Owner.
statusstringoptionalkann null sein
Filter nach Status: open (nicht erledigt/abgebrochen), completed, overdue (offen + überfällig), canceled. Weglassen für jeden Status.
Erlaubte Werte: opencompletedoverduecanceled
pagenumberoptional
Seite (beginnend bei 1, Standard 1).
pageSizenumberoptional
Seitengröße (Standard 25, max. 100).

Antwort: je Eintrag in items

taskIdstringPflicht
Id der Aufgabe.
subjectstringPflicht
Betreff der Aufgabe.
descriptionstringPflichtkann null sein
Beschreibung der Aufgabe; null, wenn nicht gesetzt.
ownerIdstringPflicht
Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
responsibleUserIdstringPflichtkann null sein
Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
dueDatestringPflichtkann null sein
Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
isDonebooleanPflicht
Ob die Aufgabe als erledigt markiert ist.
doneOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
isCanceledbooleanPflicht
Ob die Aufgabe abgebrochen ist.
canceledOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
recordingSummaryIdstringPflichtkann null sein
Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
appointmentIdstringPflichtkann null sein
Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
createdOnstringPflicht
Erstellungszeitstempel (ISO 8601).
modifiedOnstringPflicht
Zeitstempel der letzten Änderung (ISO 8601).

Jede Seite trägt außerdem page, pageSize, total, hasMore.

Statuscodes

200Erfolg
400
Ungültige Anfrage (Validierungsfehler).
401
Fehlender oder ungültiger Bearer-Token.
403
Verboten (unzureichende Berechtigungen).
404
Ressource nicht gefunden oder nicht zugänglich.
429
Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.
500
Interner Serverfehler.

Anfrage

cURL
JavaScript
Python

curl -X POST "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/tasks/search" \
  -H "Authorization: Bearer $SALLY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "search": "pricing",
  "responsible": "string",
  "status": "open",
  "page": 1,
  "pageSize": 25
}'

const response = await fetch(`https://api.sally.io/v1.0/directories/${directoryId}/tasks/search`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "search": "pricing",
    "responsible": "string",
    "status": "open",
    "page": 1,
    "pageSize": 25
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    f"https://api.sally.io/v1.0/directories/{directory_id}/tasks/search",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
    json={
        "search": "pricing",
        "responsible": "string",
        "status": "open",
        "page": 1,
        "pageSize": 25,
    },
)
data = response.json()

Beispielantwort 200 OK

{
  "page": 1,
  "pageSize": 25,
  "total": 137,
  "hasMore": true,
  "items": [
    {
      "taskId": "6ceba541-fa71-44c7-a7f7-644d56b1b85d",
      "subject": "Quarterly planning",
      "description": "string",
      "ownerId": "e51b6a79-43bf-494f-a264-6825f41b0fb5",
      "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
      "dueDate": "2026-09-24T09:30:00Z",
      "isDone": true,
      "doneOn": "2026-09-24T09:30:00Z",
      "isCanceled": true,
      "canceledOn": "2026-09-24T09:30:00Z",
      "recordingSummaryId": "731180f9-257a-46cf-a7e3-8ca508fb9c35",
      "appointmentId": "d4398f97-cd92-4d21-a6ec-4aab0a85441b",
      "createdOn": "2026-09-24T09:30:00Z",
      "modifiedOn": "2026-09-24T09:30:00Z"
    }
  ]
}

Gibt eine einzelne Aufgabe anhand ihrer Id zurück

GET/v1.0/directories/{directoryId}/tasks/{taskId}

Der Aufrufer muss die Aufgabe ansehen dürfen (Owner, Verantwortlicher oder Admin/Owner).

Feldübersicht aus der Spezifikation

Felder der Antwort:

taskId (string): Id der Aufgabe.
subject (string): Betreff der Aufgabe.
description (string | null): Beschreibung der Aufgabe; null, wenn nicht gesetzt.
ownerId (string): Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
responsibleUserId (string | null): Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
dueDate (string | null): Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
isDone (boolean): ob die Aufgabe als erledigt markiert ist.
doneOn (string | null): Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
isCanceled (boolean): ob die Aufgabe abgebrochen ist.
canceledOn (string | null): Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
recordingSummaryId (string | null): Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
appointmentId (string | null): Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
createdOn (string): Erstellungszeitstempel (ISO 8601).
modifiedOn (string): Zeitstempel der letzten Änderung (ISO 8601).

Pfadparameter

directoryIdstringPflicht
Id des Unternehmenskontos (des Sally-Firmenkontos), zu dem die Ressource gehört. Die Unternehmenskonten, die ein Token ansprechen kann, listet GET /v1.0/me/directories/memberships auf.
taskIdstringPflicht
Id der Aufgabe.

Query-Parameter

fieldsstringoptional
Kommagetrennte Liste der Felder, die zurückgegeben werden sollen. Lässt du den Parameter weg, bekommst du alle Felder, auch solche, die in Zukunft hinzukommen. Das ist deine Entscheidung: Nenne deine Felder explizit, wenn du davor geschützt sein willst.
Nur Felder der ersten Ebene können angegeben werden. Eine verschachtelte Liste wie attendees, tags oder sectionItems wird ganz oder gar nicht zurückgegeben; attendees.name wird nicht unterstützt.
Bei einer paginierten Antwort gilt die Auswahl für die Einträge in items; page, pageSize, total und hasMore werden immer zurückgegeben. Ein unbekannter Name wird mit 400 abgelehnt statt ignoriert.
Hier auswählbar: appointmentId, canceledOn, createdOn, description, doneOn, dueDate, isCanceled, isDone, modifiedOn, ownerId, recordingSummaryId, responsibleUserId, subject, taskId.
Beispiel: appointmentId,canceledOn

Antwort

taskIdstringPflicht
Id der Aufgabe.
subjectstringPflicht
Betreff der Aufgabe.
descriptionstringPflichtkann null sein
Beschreibung der Aufgabe; null, wenn nicht gesetzt.
ownerIdstringPflicht
Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
responsibleUserIdstringPflichtkann null sein
Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
dueDatestringPflichtkann null sein
Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
isDonebooleanPflicht
Ob die Aufgabe als erledigt markiert ist.
doneOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
isCanceledbooleanPflicht
Ob die Aufgabe abgebrochen ist.
canceledOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
recordingSummaryIdstringPflichtkann null sein
Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
appointmentIdstringPflichtkann null sein
Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
createdOnstringPflicht
Erstellungszeitstempel (ISO 8601).
modifiedOnstringPflicht
Zeitstempel der letzten Änderung (ISO 8601).

Statuscodes

200Erfolg
400
Ungültige Anfrage (Validierungsfehler).
401
Fehlender oder ungültiger Bearer-Token.
404
Ressource nicht gefunden oder nicht zugänglich.
429
Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.
500
Interner Serverfehler.

Anfrage

cURL
JavaScript
Python

curl "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SALLY_TOKEN"

const response = await fetch(`https://api.sally.io/v1.0/directories/${directoryId}/tasks/${taskId}`, {
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    f"https://api.sally.io/v1.0/directories/{directory_id}/tasks/{task_id}",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
)
data = response.json()

Beispielantwort 200 OK

{
  "taskId": "6ceba541-fa71-44c7-a7f7-644d56b1b85d",
  "subject": "Quarterly planning",
  "description": "string",
  "ownerId": "e51b6a79-43bf-494f-a264-6825f41b0fb5",
  "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
  "dueDate": "2026-09-24T09:30:00Z",
  "isDone": true,
  "doneOn": "2026-09-24T09:30:00Z",
  "isCanceled": true,
  "canceledOn": "2026-09-24T09:30:00Z",
  "recordingSummaryId": "731180f9-257a-46cf-a7e3-8ca508fb9c35",
  "appointmentId": "d4398f97-cd92-4d21-a6ec-4aab0a85441b",
  "createdOn": "2026-09-24T09:30:00Z",
  "modifiedOn": "2026-09-24T09:30:00Z"
}

Aktualisiert eine Aufgabe (teilweise Aktualisierung)

PATCH/v1.0/directories/{directoryId}/tasks/{taskId}

Aktualisiert eine Aufgabe. Nur die übergebenen Felder werden geändert; weggelassene Felder behalten ihren aktuellen Wert, ein null-Wert leert ein Feld explizit. Der Aufrufer muss die Aufgabe bearbeiten dürfen.

Feldübersicht aus der Spezifikation

Body-Felder:

subject (string, optional): neuer Betreff der Aufgabe (1..1000 Zeichen).
description (string, optional): neue Beschreibung der Aufgabe (max. 4000 Zeichen); null zum Entfernen.
responsibleUserId (string, optional): neue Id des verantwortlichen Nutzers; null, um die Zuweisung aufzuheben.
dueDate (string, optional): neues Fälligkeitsdatum als ISO 8601-String; null zum Entfernen.

Pfadparameter

directoryIdstringPflicht
Id des Unternehmenskontos (des Sally-Firmenkontos), zu dem die Ressource gehört. Die Unternehmenskonten, die ein Token ansprechen kann, listet GET /v1.0/me/directories/memberships auf.
taskIdstringPflicht
Id der Aufgabe.

Query-Parameter

fieldsstringoptional
Kommagetrennte Liste der Felder, die zurückgegeben werden sollen. Lässt du den Parameter weg, bekommst du alle Felder, auch solche, die in Zukunft hinzukommen. Das ist deine Entscheidung: Nenne deine Felder explizit, wenn du davor geschützt sein willst.
Nur Felder der ersten Ebene können angegeben werden. Eine verschachtelte Liste wie attendees, tags oder sectionItems wird ganz oder gar nicht zurückgegeben; attendees.name wird nicht unterstützt.
Bei einer paginierten Antwort gilt die Auswahl für die Einträge in items; page, pageSize, total und hasMore werden immer zurückgegeben. Ein unbekannter Name wird mit 400 abgelehnt statt ignoriert.
Hier auswählbar: appointmentId, canceledOn, createdOn, description, doneOn, dueDate, isCanceled, isDone, modifiedOn, ownerId, recordingSummaryId, responsibleUserId, subject, taskId.
Beispiel: appointmentId,canceledOn

Request-Body application/json

subjectstringoptional
Neuer Betreff der Aufgabe (1..1000 Zeichen).
descriptionstringoptionalkann null sein
Neue Beschreibung der Aufgabe (max. 4000 Zeichen); null zum Entfernen.
responsibleUserIdstringoptionalkann null sein
Neue Id des verantwortlichen Nutzers; null, um die Zuweisung aufzuheben.
dueDatestringoptionalkann null sein
Neues Fälligkeitsdatum als ISO 8601-String; null zum Entfernen.

Antwort

taskIdstringPflicht
Id der Aufgabe.
subjectstringPflicht
Betreff der Aufgabe.
descriptionstringPflichtkann null sein
Beschreibung der Aufgabe; null, wenn nicht gesetzt.
ownerIdstringPflicht
Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
responsibleUserIdstringPflichtkann null sein
Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
dueDatestringPflichtkann null sein
Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
isDonebooleanPflicht
Ob die Aufgabe als erledigt markiert ist.
doneOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
isCanceledbooleanPflicht
Ob die Aufgabe abgebrochen ist.
canceledOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
recordingSummaryIdstringPflichtkann null sein
Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
appointmentIdstringPflichtkann null sein
Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
createdOnstringPflicht
Erstellungszeitstempel (ISO 8601).
modifiedOnstringPflicht
Zeitstempel der letzten Änderung (ISO 8601).

Statuscodes

200Erfolg
400
Ungültige Anfrage (Validierungsfehler).
401
Fehlender oder ungültiger Bearer-Token.
403
Verboten (unzureichende Berechtigungen).
404
Ressource nicht gefunden oder nicht zugänglich.
429
Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.
500
Interner Serverfehler.

Anfrage

cURL
JavaScript
Python

curl -X PATCH "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SALLY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "subject": "Quarterly planning",
  "description": "string",
  "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
  "dueDate": "2026-09-24T09:30:00Z"
}'

const response = await fetch(`https://api.sally.io/v1.0/directories/${directoryId}/tasks/${taskId}`, {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "subject": "Quarterly planning",
    "description": "string",
    "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
    "dueDate": "2026-09-24T09:30:00Z"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    f"https://api.sally.io/v1.0/directories/{directory_id}/tasks/{task_id}",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
    json={
        "subject": "Quarterly planning",
        "description": "string",
        "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
        "dueDate": "2026-09-24T09:30:00Z",
    },
)
data = response.json()

Beispielantwort 200 OK

{
  "taskId": "6ceba541-fa71-44c7-a7f7-644d56b1b85d",
  "subject": "Quarterly planning",
  "description": "string",
  "ownerId": "e51b6a79-43bf-494f-a264-6825f41b0fb5",
  "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
  "dueDate": "2026-09-24T09:30:00Z",
  "isDone": true,
  "doneOn": "2026-09-24T09:30:00Z",
  "isCanceled": true,
  "canceledOn": "2026-09-24T09:30:00Z",
  "recordingSummaryId": "731180f9-257a-46cf-a7e3-8ca508fb9c35",
  "appointmentId": "d4398f97-cd92-4d21-a6ec-4aab0a85441b",
  "createdOn": "2026-09-24T09:30:00Z",
  "modifiedOn": "2026-09-24T09:30:00Z"
}

Löscht eine Aufgabe (weiches Löschen, Soft Delete)

DELETE/v1.0/directories/{directoryId}/tasks/{taskId}

Nur der Owner der Aufgabe oder ein Admin/Owner darf eine Aufgabe löschen.

Pfadparameter

directoryIdstringPflicht
Id des Unternehmenskontos (des Sally-Firmenkontos), zu dem die Ressource gehört. Die Unternehmenskonten, die ein Token ansprechen kann, listet GET /v1.0/me/directories/memberships auf.
taskIdstringPflicht
Id der Aufgabe.

Statuscodes

204Erfolg
400
Ungültige Anfrage (Validierungsfehler).
401
Fehlender oder ungültiger Bearer-Token.
403
Verboten (unzureichende Berechtigungen).
404
Ressource nicht gefunden oder nicht zugänglich.
429
Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.
500
Interner Serverfehler.

Anfrage

cURL
JavaScript
Python

curl -X DELETE "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SALLY_TOKEN"

const response = await fetch(`https://api.sally.io/v1.0/directories/${directoryId}/tasks/${taskId}`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
  },
});
console.log(response.status); // 204

import os
import requests

response = requests.delete(
    f"https://api.sally.io/v1.0/directories/{directory_id}/tasks/{task_id}",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
)
print(response.status_code)  # 204

Beispielantwort 204 No Content

Kein Inhalt. Ein erfolgreicher Aufruf liefert einen leeren Body.

Schaltet den Erledigt-Status einer Aufgabe um

POST/v1.0/directories/{directoryId}/tasks/{taskId}/done

Schaltet den Erledigt-Status einer Aufgabe um.

Feldübersicht aus der Spezifikation

Body-Felder:

isDone (boolean, Pflicht): true, um die Aufgabe als erledigt zu markieren, false, um sie wieder zu öffnen.

Pfadparameter

directoryIdstringPflicht
Id des Unternehmenskontos (des Sally-Firmenkontos), zu dem die Ressource gehört. Die Unternehmenskonten, die ein Token ansprechen kann, listet GET /v1.0/me/directories/memberships auf.
taskIdstringPflicht
Id der Aufgabe.

Query-Parameter

fieldsstringoptional
Kommagetrennte Liste der Felder, die zurückgegeben werden sollen. Lässt du den Parameter weg, bekommst du alle Felder, auch solche, die in Zukunft hinzukommen. Das ist deine Entscheidung: Nenne deine Felder explizit, wenn du davor geschützt sein willst.
Nur Felder der ersten Ebene können angegeben werden. Eine verschachtelte Liste wie attendees, tags oder sectionItems wird ganz oder gar nicht zurückgegeben; attendees.name wird nicht unterstützt.
Bei einer paginierten Antwort gilt die Auswahl für die Einträge in items; page, pageSize, total und hasMore werden immer zurückgegeben. Ein unbekannter Name wird mit 400 abgelehnt statt ignoriert.
Hier auswählbar: appointmentId, canceledOn, createdOn, description, doneOn, dueDate, isCanceled, isDone, modifiedOn, ownerId, recordingSummaryId, responsibleUserId, subject, taskId.
Beispiel: appointmentId,canceledOn

Request-Body application/json

isDonebooleanPflicht
True, um die Aufgabe als erledigt zu markieren, false, um sie wieder zu öffnen.

Antwort

taskIdstringPflicht
Id der Aufgabe.
subjectstringPflicht
Betreff der Aufgabe.
descriptionstringPflichtkann null sein
Beschreibung der Aufgabe; null, wenn nicht gesetzt.
ownerIdstringPflicht
Id des Nutzers, dem die Aufgabe gehört (der sie erstellt hat).
responsibleUserIdstringPflichtkann null sein
Id des für die Aufgabe verantwortlichen Nutzers; null, wenn nicht zugewiesen.
dueDatestringPflichtkann null sein
Fälligkeitsdatum (ISO 8601); null, wenn kein Fälligkeitsdatum gesetzt ist.
isDonebooleanPflicht
Ob die Aufgabe als erledigt markiert ist.
doneOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe erledigt wurde (ISO 8601); null, wenn nicht erledigt.
isCanceledbooleanPflicht
Ob die Aufgabe abgebrochen ist.
canceledOnstringPflichtkann null sein
Zeitstempel, zu dem die Aufgabe abgebrochen wurde (ISO 8601); null, wenn nicht abgebrochen.
recordingSummaryIdstringPflichtkann null sein
Id der Zusammenfassung, aus der diese Aufgabe stammt; null, wenn keine.
appointmentIdstringPflichtkann null sein
Id des Termins, mit dem diese Aufgabe verknüpft ist; null, wenn keiner.
createdOnstringPflicht
Erstellungszeitstempel (ISO 8601).
modifiedOnstringPflicht
Zeitstempel der letzten Änderung (ISO 8601).

Statuscodes

200Erfolg
400
Ungültige Anfrage (Validierungsfehler).
401
Fehlender oder ungültiger Bearer-Token.
403
Verboten (unzureichende Berechtigungen).
404
Ressource nicht gefunden oder nicht zugänglich.
429
Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.
500
Interner Serverfehler.

Anfrage

cURL
JavaScript
Python

curl -X POST "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/tasks/$TASK_ID/done" \
  -H "Authorization: Bearer $SALLY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "isDone": true
}'

const response = await fetch(`https://api.sally.io/v1.0/directories/${directoryId}/tasks/${taskId}/done`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "isDone": true
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    f"https://api.sally.io/v1.0/directories/{directory_id}/tasks/{task_id}/done",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
    json={
        "isDone": True,
    },
)
data = response.json()

Beispielantwort 200 OK

{
  "taskId": "6ceba541-fa71-44c7-a7f7-644d56b1b85d",
  "subject": "Quarterly planning",
  "description": "string",
  "ownerId": "e51b6a79-43bf-494f-a264-6825f41b0fb5",
  "responsibleUserId": "1b84577d-c09e-446b-a5b8-71591dfde929",
  "dueDate": "2026-09-24T09:30:00Z",
  "isDone": true,
  "doneOn": "2026-09-24T09:30:00Z",
  "isCanceled": true,
  "canceledOn": "2026-09-24T09:30:00Z",
  "recordingSummaryId": "731180f9-257a-46cf-a7e3-8ca508fb9c35",
  "appointmentId": "d4398f97-cd92-4d21-a6ec-4aab0a85441b",
  "createdOn": "2026-09-24T09:30:00Z",
  "modifiedOn": "2026-09-24T09:30:00Z"
}

Listet die Aufgaben eines Unternehmenskontos auf (paginiert, optional gefiltert)​

Pfadparameter

Query-Parameter

Antwort: je Eintrag in items

Statuscodes

Erstellt eine Aufgabe​

Pfadparameter

Query-Parameter

Request-Body application/json

Antwort

Statuscodes

Durchsucht Aufgaben (Parameter im Body)​

Pfadparameter

Query-Parameter

Request-Body application/json

Antwort: je Eintrag in items

Statuscodes

Gibt eine einzelne Aufgabe anhand ihrer Id zurück​

Pfadparameter

Query-Parameter

Antwort

Statuscodes

Aktualisiert eine Aufgabe (teilweise Aktualisierung)​

Pfadparameter

Query-Parameter

Request-Body application/json

Antwort

Statuscodes

Löscht eine Aufgabe (weiches Löschen, Soft Delete)​

Pfadparameter

Statuscodes

Schaltet den Erledigt-Status einer Aufgabe um​

Pfadparameter

Query-Parameter

Request-Body application/json

Antwort

Statuscodes

Listet die Aufgaben eines Unternehmenskontos auf (paginiert, optional gefiltert)

Erstellt eine Aufgabe

Durchsucht Aufgaben (Parameter im Body)

Gibt eine einzelne Aufgabe anhand ihrer Id zurück

Aktualisiert eine Aufgabe (teilweise Aktualisierung)

Löscht eine Aufgabe (weiches Löschen, Soft Delete)

Schaltet den Erledigt-Status einer Aufgabe um