Agenten

Agent löschen

Einen Agenten endgültig entfernen.

DELETEhttps://app.elunos.ai/api/v1/spaces/{space}/agents/{agent}

Löscht einen Agenten. Ist ihm noch eine Telefonnummer zugewiesen, lehnt die API mit 409 referenced ab. Weise die Nummer in der Plattform erst einem anderen Agenten zu.

Pfadparameter

spacestringPflicht

Slug des Space, z. B. `praxis-mueller`. Steht in der Antwort von `GET /spaces`.

agentuuidPflicht

ID des Agenten.

Abfrageparameter

expected_updated_atdatetime

`updated_at` aus deinem letzten Lesen. Weicht der gespeicherte Wert ab, antwortet die API mit 409 `stale` und dem aktuellen Stand, statt eine fremde Änderung zu überschreiben.

Beispiel

curl -X DELETE https://app.elunos.ai/api/v1/spaces/praxis-mueller/agents/0199a3c2-7d4e-7b21-9f3a-2c5e8d1b4a70 \
  -H "Authorization: Bearer np_xxxxxxxx"

Antwort

Bei Erfolg die gelöschte Ressource in data. Wird noch darauf verwiesen:

{
  "code": "referenced",
  "message": "The agent is still assigned to a phone number.",
  "references": [
    {
      "type": "phone_number",
      "id": "0199a3e1-…",
      "name": "+49 221 123456"
    }
  ]
}

Gespräche des Agenten bleiben erhalten. Der Vorgang lässt sich nicht rückgängig machen.