Aufgaben

Aufgabe lesen

GET https://api.propstack.de/v1/tasks/:id

Request Parameter

Name	Type	Description
include	string	Standardwert ist: clients,units,projects,viewings

200

{
    "id": 123,
    "title": "Titel"
    ...
}

Aufgabe anlegen

POST https://api.propstack.de/v1/tasks

Beim Anlegen einer Aufgabe muss der Parameter is_reminder auf true gesetzt werden. Außerdem muss mindestens note_type_id oder title ausgefüllt worden sein, sonst kann die Aufgabe nicht angelegt werden. Alle Parameter zur Aufgabe müssen sich in dem Objekt task befinden.

Request Body

Name	Type	Description
task__note_type_id	integer	ID des Aufgabentypes der Aufgabe
task__broker_id	integer	ID des Nutzers, dem die Aufgabe zugewiesen werden soll
task__is_reminder	boolean	muss auf true gesetzt werden, damit die Aktivität als Aufgabe erkannt wird und nicht als einfache Notiz. Wenn due_date gesetzt ist, muss dieses Feld nicht zusätzlich gesetzt werden.
task__project_ids	array	Eine Liste von Projekt-IDs, die mit der Aufgabe verknüpft werden sollen
task__property_ids	array	Eine Liste von Objekt-IDs, die mit der Aufgabe verknüpft werden sollen
task__client_ids	array	Eine Liste von Kontakt-IDs, die mit der Aufgabe verknüpft werden sollen. In der Regel will man nur einen Kontakt mit der Aufgabe verknüpfen.
task__due_date	string	Datum+Uhrzeit, wann die Fälligkeit für die Aufgabe ist
task__body	string	Weitere Beschreibung zur Aufgabe
task__title	string	Titel der Aufgabe
task	object	Alle Felder zur Aufgabe müssen in einem Task-Objekt umschlossen werden

201 Aufgabe wurde erfolgreich angelegt

{
    "id": 123,
    "activity_id": 456
}

Beispiel Anfrage:

{
    "task": {
        "title": "Kontakt zurückanrufen",
        "note_type_id": 123,
        "broker_id": 2,
        "client_ids": [321]
    }
}

Aufgabe bearbeiten

PUT https://api.propstack.de/v1/tasks/:id

Beispiel Anfrage:

{
    "task": {
        "title": "Titel",
        "broker_id": 3,
        "client_ids": [322]
    }
}

Aufgabe Löschen

DELETE https://api.propstack.de/v1/tasks/:id

200

{
    "ok": true
}