REST-endpoints

Alle endpoints gebruiken basis-URL https://api.hashee.ai. Authenticatie gaat via Authorization: Bearer {token} tenzij gemarkeerd als publiek.

Auth

Methode	Pad	Auth	Beschrijving
POST	/auth/register	Publiek	Nieuw account registreren
POST	/auth/login	Publiek	Wachtwoord-login
POST	/auth/login-code	Publiek	Verificatiecode-login
POST	/auth/send-code	Publiek	Verificatiecode versturen
POST	/auth/refresh	Cookie	Access-token vernieuwen
POST	/auth/logout	JWT	Huidige sessie uitloggen
POST	/auth/reset-password	Publiek	Accountwachtwoord herstellen
POST	/auth/change-password	JWT	Accountwachtwoord wijzigen
POST	/auth/change-protection-password	JWT	Beschermingswachtwoord wijzigen
GET	/auth/me	JWT	Huidig gebruikersprofiel ophalen
POST	/auth/passkey/begin	Publiek	Passkey-login starten
POST	/auth/passkey/complete	Publiek	Passkey-login voltooien
POST	/auth/passkey/register/begin	JWT	Passkey-registratie starten
POST	/auth/passkey/register/complete	JWT	Passkey-registratie voltooien
GET	/auth/passkey/credentials	JWT	Passkey-referenties oplijsten
PATCH	/auth/passkey/credentials/:id	JWT	Een Passkey hernoemen
DELETE	/auth/passkey/credentials/:id	JWT	Een Passkey verwijderen

Gebruikers

Methode	Pad	Auth	Beschrijving
GET	/users/me	JWT	Eigen profiel ophalen
PATCH	/users/me	JWT	Eigen profiel bijwerken
GET	/users/:id	JWT	Gebruiker ophalen op ID
GET	/users/search	JWT	Gebruikers zoeken
DELETE	/users/me	JWT	Account deactiveren en verwijderen
PATCH	/users/contacts/:id	JWT	Contactbijnaam instellen

E2EE-sleutels

Methode	Pad	Auth	Beschrijving
POST	/keys/backup	JWT	Versleutelde sleutelback-up uploaden
GET	/keys/backup	JWT	Sleutelback-up downloaden
PUT	/keys/backup	JWT	Sleutelback-up bijwerken
GET	/keys/users/:id/devices	JWT	Publieke sleutels van apparaten ophalen
GET	/keys/agents/:id	JWT	Publieke sleutel van agent ophalen
GET	/keys/groups/:id	JWT	Groepsversleutelingssleutel ophalen
POST	/keys/groups/:id/rotate	JWT	Groepssleutel roteren
POST	/keys/rotation/request	JWT	H2H-sleutelrotatie aanvragen
POST	/keys/rotation/confirm	JWT	H2H-sleutelrotatie bevestigen
POST	/agents/:id/keys/register	Agent	Publieke sleutel van agent registreren

Gesprekken

Methode	Pad	Auth	Beschrijving
GET	/conversations	JWT	Gesprekken oplijsten
PATCH	/conversations/:id	JWT	Gespreksinstellingen bijwerken
DELETE	/conversations/:id	JWT	Gesprek verbergen
POST	/conversations/:id/read	JWT	Als gelezen markeren
GET	/conversations/:id/messages	JWT	Berichtgeschiedenis ophalen
GET	/conversations/:id/media	JWT	Media in gesprek ophalen
PUT	/conversations/:id/draft	JWT	Concept opslaan
GET	/conversations/:id/draft	JWT	Concept ophalen
DELETE	/conversations/:id/draft	JWT	Concept verwijderen

Berichten

Methode	Pad	Auth	Beschrijving
POST	/conversations/:id/messages	JWT	Een bericht versturen
POST	/messages/:id/recall	JWT	Een bericht intrekken
POST	/messages/:id/reactions	JWT	Reactie toevoegen/verwijderen
GET	/messages/:id/reactions	JWT	Reactielijst ophalen
POST	/messages/forward	JWT	Berichten doorsturen (max 10 doelen)
PATCH	/messages/:id/artifact	Agent	Een artifact bijwerken

Groepen

Methode	Pad	Auth	Beschrijving
POST	/groups	JWT	Groep aanmaken
GET	/groups/:id	JWT	Groepsdetails ophalen
PATCH	/groups/:id	JWT	Groepsinstellingen bijwerken
DELETE	/groups/:id	JWT	Groep verwijderen
GET	/groups/:id/members	JWT	Leden oplijsten
POST	/groups/:id/members	JWT	Leden toevoegen
DELETE	/groups/:gid/members/:mid	JWT	Lid verwijderen
PATCH	/groups/:gid/members/:mid	JWT	Lidrol bijwerken
PATCH	/groups/:gid/members/me	JWT	Eigen groepsprofiel bijwerken
POST	/groups/:gid/leave	JWT	Groep verlaten
POST	/groups/:id/transfer	JWT	Eigenaarschap overdragen
POST	/groups/:gid/join	JWT	Groep toetreden via deelcode
GET	/groups/:gid/join-requests	JWT	Openstaande toetredingsverzoeken oplijsten
POST	/groups/:gid/join-requests/:uid/approve	JWT	Toetredingsverzoek goedkeuren
POST	/groups/:gid/join-requests/:uid/reject	JWT	Toetredingsverzoek afwijzen
POST	/groups/:id/pinned-messages	JWT	Een bericht vastpinnen
GET	/groups/:id/pinned-messages	JWT	Vastgepinde berichten oplijsten
DELETE	/groups/:gid/pinned-messages/:mid	JWT	Een bericht losmaken
POST	/groups/:gid/members/:mid/mute	JWT	Een lid dempen
POST	/groups/:id/agent-instances	JWT	Agent aan groep toevoegen
DELETE	/groups/:gid/agent-instances/:iid	JWT	Agent uit groep verwijderen

Agentbeheer (maker)

Methode	Pad	Auth	Beschrijving
POST	/agents	JWT	Agent aanmaken
GET	/agents	JWT	Eigen agents oplijsten
GET	/agents/:id	JWT	Agentdetails ophalen
PATCH	/agents/:id	JWT	Agentprofiel bijwerken
DELETE	/agents/:id	JWT	Agent verwijderen
GET	/agents/check-id	JWT	Beschikbaarheid aangepast ID controleren
GET	/agents/:id/token	JWT	Agent-token ophalen
POST	/agents/:id/token/regenerate	JWT	Token regenereren
GET	/agents/:id/commands	JWT	Slash-commando’s ophalen
POST	/agents/:id/commands	JWT	Slash-commando’s bijwerken
GET	/agents/:id/invite-codes	JWT	Uitnodigingscodes oplijsten
POST	/agents/:id/invite-codes	JWT	Uitnodigingscode aanmaken
PATCH	/invite-codes/:id	JWT	Uitnodigingscode bijwerken
GET	/agents/:id/requests	JWT	Gebruikersverzoeken oplijsten
POST	/agents/:id/requests/:rid/approve	JWT	Gebruikersverzoek goedkeuren
POST	/agents/:id/users/:uid/suspend	JWT	Gebruiker schorsen
POST	/agents/:id/users/:uid/restore	JWT	Gebruiker herstellen
GET	/agents/:id/governance	JWT	Governance-status ophalen

Agent-endpoints (Agent Token-auth)

Methode	Pad	Auth	Beschrijving
POST	/agents/:id/conversations/:cid/messages	Agent	Bericht versturen
POST	/agents/:id/typing	Agent	Typindicator versturen
GET	/agents/:id/messages/poll	Agent	Berichten pollen
GET	/agents/:id/conversations	Agent	Gesprekken oplijsten
GET	/agents/:id/conversations/:cid/messages	Agent	Gespreksberichten ophalen
POST	/agents/:id/files	Agent	Bestandsupload-URL aanvragen
PUT	/agents/:id/files/:uploadId/upload	Agent	Binair bestand uploaden

Bestanden

Methode	Pad	Auth	Beschrijving
POST	/files/presign	JWT	Presigned upload-URL aanvragen
PUT	/files/:upload_id/upload	JWT	Binair bestand uploaden
POST	/files/confirm	JWT	Upload bevestigen met SHA-256

Overig

Methode	Pad	Auth	Beschrijving
GET	/health	Publiek	Gezondheidscontrole
GET	/search	JWT	Actoren en artifacts zoeken
POST	/reports	JWT	Een agent rapporteren
POST	/share/friend	JWT	Deellink voor vriend aanmaken
POST	/share/agent	JWT	Deellink voor agent aanmaken
POST	/share/group	JWT	Deellink voor groep aanmaken
GET	/share/*	Publiek	Deellink resolven

Volgende stappen

• WebSocket-gebeurtenissen — Referentie voor realtime gebeurtenissen
• Authenticatie — Details authenticatiestroom
• Foutcodes — Foutcodetabel