{"openapi":"3.0.1","info":{"description":"De Agenda API biedt toegang tot agenda-afspraken binnen Realworks. Met deze API kunnen externe applicaties agenda-items aanmaken, bijwerken en raadplegen voor medewerkers en afdelingen. De API ondersteunt onder andere afspraken, statussen, types, gekoppelde relaties en projecten. De Agenda API ondersteunt zowel lees- als schrijfacties.\n\n#### Zo gebruik je deze API\n* Haal eerst de beschikbare agenda-statussen en agenda-types op.\n* Maak een agenda-afspraak aan of werk een bestaande afspraak bij met `POST /agenda/v3` en `PUT /agenda/v3/{agendaId}`.\n* Haal agenda-afspraken op per medewerker of afdeling met `GET /agenda/v3/medewerker/{medewerkerId}` en `GET /agenda/v3/afdeling/{afdelingscode}`.\n* Gebruik het `agendaId` om een specifiek agenda-item op te halen met `GET /agenda/v3/afdeling/{afdelingscode}/agenda/{agendaId}`.\n\n#### Relaties aanmaken\nBij het aanmaken van relaties via de relaties V3 endpoints controleert Realworks eerst of er een bestaande relatie kan worden gematcht voordat er een nieuwe relatie wordt aangemaakt.\n\nAlle relatietypes worden gecontroleerd op e-mailadres en of de relatie wel of niet in quarantaine staat.\n\n* Bij particulieren en contactpersonen wordt gecontroleerd op mobiel nummer en telefoonnummer 1 en 2.\n* Bij bedrijven wordt gecontroleerd op bedrijfsnaam.\n* Een contactpersoon moet ook gekoppeld zijn aan een bedrijf (`companyId`).\n\n#### Bijzonderheden\n* Agenda-statussen en -types zijn configureerbaar per afdeling en kunnen verschillen tussen makelaarskantoren.\n* Gebruik status- en typewaarden niet als vaste enumeraties; haal de beschikbare waarden op via de daarvoor beschikbare endpoints.\n* Niet ieder agendapunt bevat een gekoppelde relatie of project.\n* Datum- en tijdvelden worden als `date-time` uitgewisseld.\n\n#### Laatste wijzigingen\n##### 15-07-2025\n* Request payloads gebruiken `medewerkerId` en `relatieId` in plaats van codes.\n* De Agenda V3-endpoints zijn geherstructureerd voor een consistente opbouw.\n* Een nieuw endpoint toegevoegd voor het aanmaken van relaties ten behoeve van agenda-koppelingen.","title":"Agenda"},"externalDocs":{"description":"OpenAPI Specification","url":"/openapi-doc/v1/Agenda"},"servers":[{"url":"https://api.realworks.nl"}],"security":[{"rwauth":[]}],"tags":[{"name":"Agenda"}],"paths":{"/agenda/v3":{"post":{"description":"### Migratie-overzicht (t.o.v. vorige versies)\n\n**Gewijzigd**\n* Request payload gebruikt ID's i.p.v. codes: `medewerkercode` → `medewerkerId`.\n* Aanmaker gebruikt ID i.p.v. code: `medewerkerscodeAanmaker` → `medewerkerIdAanmaker`.\n* Als je vanuit v1 komt: `relatie` (object) → `relatieId` (integer).\n\n**Wat moet je aanpassen**\n* Stuur `medewerkerId` i.p.v. `medewerkercode`.\n* (Indien gebruikt) stuur `medewerkerIdAanmaker` i.p.v. `medewerkerscodeAanmaker`.\n* Als je vanuit v1 komt: vervang het `relatie` object door `relatieId` (integer).\n","operationId":"verstuurGegevensAgendapunt-v3","requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/AgendaCreatePayloadV3"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncWritePathReply"}}},"description":"Response ontvangen"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"description":"Too Many Requests"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Verstuur een nieuw agendapunt naar het Realworks systeem","tags":["Agenda"]}},"/agenda/v3/afdeling/{afdelingscode}":{"get":{"description":"### Migratie-overzicht (t.o.v. vorige versies)\n\n**Gewijzigd**\n* Endpointpad gewijzigd naar `/agenda/v3/afdeling/{afdelingscode}`.\n* Response schema is in v3 `ApiSearchResultsAgendaV2` (de response sluit dus aan op de bestaande v2-structuur).\n\n### Wat moet je aanpassen\n* Update de basis-URL naar `/agenda/v3/afdeling/{afdelingscode}`.\n","operationId":"zoekenAgendaAlleMedewerkers_1","parameters":[{"description":"Vestiging (eigenaar van het object)","in":"path","name":"afdelingscode","required":true,"schema":{"type":"string"}},{"in":"query","name":"actief","required":false,"schema":{"type":"string","enum":["true","false","all"],"default":"true"}},{"description":"MedewerkerId van de aanmaker van het agendapunt","in":"query","name":"medewerkerIdAanmaker","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"Projectcode","in":"query","name":"projectcode","required":false,"schema":{"type":"string"}},{"description":"Agendatype","explode":true,"in":"query","name":"agendatypes","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form"},{"description":"Agendastatus","explode":true,"in":"query","name":"agendastatus","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form"},{"description":"Begintijd agendapunt, vanaf (ex: _2017-11-03 20:00:00_) or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"begintijdVanaf","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"Begintijd agendapunt, tot (ex: _2017-11-03 20:00:00_) or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"begintijdTot","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"Eindtijd agendapunt, vanaf (ex: _2017-11-03 20:00:00_ or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"eindtijdVanaf","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"Eindtijd agendapunt, tot (ex: _2017-11-03 20:00:00_ or _22017-11-03T20:00:00_ (Safari browser)","in":"query","name":"eindtijdTot","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"gewijzigdNa (ex: _2017-11-03 20:00:00_ or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"gewijzigdNa","required":false,"schema":{"type":"string","format":"date-time"}},{"description":" (min: _1_, max: _100_)","in":"query","name":"aantal","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer","format":"int32","default":100}},{"in":"query","name":"vanaf","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiSearchResultsAgendaV2"}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Zoeken door agendapunten van hele afdeling","tags":["Agenda"]}},"/agenda/v3/afdeling/{afdelingscode}/agenda/{agendaId}":{"get":{"description":"### Migratie-overzicht (t.o.v. vorige versies)\n\n**Nieuw**\n* In V3 is dit specifieke detail-endpoint toegevoegd waarbij de afdeling, medewerker en het agendapunt direct in het pad worden gedefinieerd.\n\n### Wat moet je aanpassen\n* Gebruik deze route voor het gericht ophalen van details op basis van:\n   + `{afdelingscode}`\n   + `{agendaId}`\n","operationId":"agendaPerAgendaId","parameters":[{"description":"Vestiging (eigenaar van het object)","in":"path","name":"afdelingscode","required":true,"schema":{"type":"string"}},{"description":"Agenda id","in":"path","name":"agendaId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/AgendaV2"}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Agenda ophalen op basis van agenda id","tags":["Agenda"]}},"/agenda/v3/medewerker/{medewerkerId}":{"get":{"description":"### Migratie-overzicht (t.o.v. vorige versies)\n\n**Gewijzigd**\n* (v1 → v3): v1 gebruikte `medewerkerscode` (string) in het pad; v3 gebruikt `medewerkerId` (integer) en een nieuwe route: `/agenda/v3/medewerker/{medewerkerId}`.\n* (v2 → v3): Het pad is identiek aan v2, enkel het versienummer in de URL verandert.\n\n### Wat moet je aanpassen\n* Als je vanuit v1 migreert: gebruik ` medewerkerId` i.p.v. `medewerkerscode` en update de route naar `/agenda/v3/medewerker/{medewerkerId}`.\n* Als je vanuit v2 migreert: update alleen de versie naar v3.\n","operationId":"zoekenAgendaAlleMedewerkers","parameters":[{"description":"MedewerkerId","in":"path","name":"medewerkerId","required":true,"schema":{"type":"integer","format":"int32"}},{"in":"query","name":"actief","required":false,"schema":{"type":"string","enum":["true","false","all"],"default":"true"}},{"description":"MedewerkerId van de aanmaker van het agendapunt","in":"query","name":"medewerkerIdAanmaker","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"Projectcode","in":"query","name":"projectcode","required":false,"schema":{"type":"string"}},{"description":"Agendatype","explode":true,"in":"query","name":"agendatypes","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form"},{"description":"Agendastatus","explode":true,"in":"query","name":"agendastatus","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form"},{"description":"Begintijd agendapunt, vanaf (ex: _2017-11-03 20:00:00_) or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"begintijdVanaf","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"Begintijd agendapunt, tot (ex: _2017-11-03 20:00:00_) or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"begintijdTot","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"Eindtijd agendapunt, vanaf (ex: _2017-11-03 20:00:00_ or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"eindtijdVanaf","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"Eindtijd agendapunt, tot (ex: _2017-11-03 20:00:00_ or _22017-11-03T20:00:00_ (Safari browser)","in":"query","name":"eindtijdTot","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"gewijzigdNa (ex: _2017-11-03 20:00:00_ or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"gewijzigdNa","required":false,"schema":{"type":"string","format":"date-time"}},{"description":" (min: _1_, max: _100_)","in":"query","name":"aantal","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer","format":"int32","default":100}},{"in":"query","name":"vanaf","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiSearchResultsAgendaV2"}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Zoeken door agendapunten van een medewerker","tags":["Agenda"]}},"/agenda/v3/relaties":{"post":{"description":"Nieuw endpoint om relaties aan te maken t.b.v. agenda-koppelingen.\n\n### Migratie-overzicht (t.o.v. vorige versies)\n\n**Nieuw**\n* In V3 is er een specifiek endpoint toegevoegd voor het aanmaken van relaties: `/agenda/v3/relaties`.\n* De request payload is flexibel en ondersteunt verschillende types via `oneOf`:\n    + `BEDRIJF`\n    + `CONTACTPERSOON`\n    + `PARTICULIER`\n\n**Wat moet je aanpassen**\n* Gebruik dit endpoint om nieuwe relaties aan te maken in plaats van generieke relatie-endpoints.\n* Zorg dat je het juiste payloadtype meestuurt op basis van de gewenste `relatiesoort`.\n","operationId":"relatiesAgendaCreëren","requestBody":{"content":{"application/json;charset=UTF-8":{"examples":{"BedrijfPayload":{"description":"BedrijfPayload","summary":"If you choose BEDRIJF in relatiesoort","value":{"relatiesoort":"BEDRIJF","bedrijfsnaam":"string","mobielTelefoonnummer":"123-1331-122","straat":"string","email":"ab@realworks.com","telefoonnummer":"123-1331-122","postcode":"112133","accountmanager":"accountManager","huisnummer":"12","huisnummertoevoeging":"1","woonplaats":"string","afdelingscode":"afdelingscode"}},"ContactPersonPayload":{"description":"ContactPersonPayload","summary":"If you choose CONTACTPERSOON in relatiesoort","value":{"titel":"string","land":"string","companyId":"string","relatiesoort":"CONTACTPERSOON","initialen":"string","tussenvoegsel":"string","achternaam":"string","geslacht":"V","roepnaam":"string","email":"ab@realworks.com","straat":"string","afdelingscode":"afdelingscode","postcode":"112133","accountmanager":"accountManager","telefoonnummer":"123-1331-122","huisnummer":"12","huisnummertoevoeging":"1","woonplaats":"string","mobielTelefoonnummer":"123-1331-122"}},"ParticulierPayload":{"description":"ParticulierPayload","summary":"If you choose PARTICULIER in relatiesoort","value":{"initialen":"string","tussenvoegsel":"string","achternaam":"string","geslacht":"M","roepnaam":"string","relatiesoort":"PARTICULIER","land":"string","titel":"string","afdelingscode":"afdelingscode","huisnummer":"12","huisnummertoevoeging":"1","woonplaats":"string","telefoonnummer":"123-1331-122","postcode":"112133","accountmanager":"accountManager","straat":"string","email":"ab@realworks.com","mobielTelefoonnummer":"123-1331-122"}}},"schema":{"oneOf":[{"$ref":"#/components/schemas/BedrijfPayload"},{"$ref":"#/components/schemas/ContactPersonPayload"},{"$ref":"#/components/schemas/ParticulierPayload"}]}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncWritePathReply"}}},"description":"Response ontvangen"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"description":"Too Many Requests"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Relatie toevoegen voor agenda","tags":["Agenda"]}},"/agenda/v3/statussen/{afdelingscode}":{"get":{"description":"Endpoint is verplaatst naar v3; functioneel gelijk gebleven.\n\n### Migratie-overzicht (t.o.v. vorige versies)\n**Gewijzigd**\n* Het endpoint is nu beschikbaar onder : `/agenda/v3/statussen/{afdelingscode}`.\n\n**Wat moet je aanpassen**\n* Update de URL in je aanroep naar `/agenda/v3/statussen/{afdelingscode}`.\n","operationId":"agendaStatuses","parameters":[{"description":"Vestiging (eigenaar van het object)","in":"path","name":"afdelingscode","required":true,"schema":{"type":"string"}},{"in":"query","name":"actief","required":false,"schema":{"type":"string","enum":["true","false","all"],"default":"true"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgendaOrTaskStatus"}}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Agenda statussen","tags":["Agenda"]}},"/agenda/v3/types/{afdelingscode}":{"get":{"description":"Endpoint is verplaatst naar v3; functioneel gelijk gebleven.\n\n### Migratie-overzicht (t.o.v. vorige versies)\n\n**Gewijzigd**\n* Het endpoint is nu beschikbaar onder : `/agenda/v3/types/{afdelingscode}`.\n\n**Wat moet je aanpassen**\n* Update de URL naar `/agenda/v3/types/{afdelingscode}`.\n","operationId":"agendaTypes","parameters":[{"description":"Vestiging (eigenaar van het object)","in":"path","name":"afdelingscode","required":true,"schema":{"type":"string"}},{"in":"query","name":"actief","required":false,"schema":{"type":"string","enum":["true","false","all"],"default":"true"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgendaType"}}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Agenda types","tags":["Agenda"]}},"/agenda/v3/{agendaId}":{"put":{"description":"### Migratie-overzicht (t.o.v. vorige versies)\n\n**Gewijzigd**\n* Update endpoint gebruikt `agendaId` in het pad: `/agenda/v3/{agendaId}` (v1/v2 update zat niet op een `{agendaId}`-pad).\n* In v3 staat `id` niet meer in de request body (v1/v2 had `id` in de body).\n* Request payload gebruikt ID's i.p.v. codes: `medewerkercode` → `medewerkerId`.\n\n**Wat moet je aanpassen**\n* Update je URL naar `/agenda/v3/{agendaId}`.\n* Haal `id` uit de body en gebruik `{agendaId}` uit het pad.\n* Stuur `medewerkerId` i.p.v. `medewerkercode`.\n","operationId":"agendagegevensBijwerken-v3","parameters":[{"description":"agenda Id","in":"path","name":"agendaId","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/AgendaUpdatePayloadV3"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncWritePathReply"}}},"description":"Response ontvangen"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"description":"Too Many Requests"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Verstuur een agendapunt naar het Realworks systeem","tags":["Agenda"]}}},"components":{"schemas":{"AgendaCreatePayloadV3":{"required":["afdelingscode","agendastatus","begintijd","eindtijd","inzage","medewerkerId"],"type":"object","properties":{"afdelingscode":{"maxLength":10,"minLength":0,"type":"string","description":"Code van het makelaarskantoor","example":"deptm1"},"afspraakGeheleDag":{"type":"boolean","description":"AfspraakGeheleDag","nullable":true,"example":false},"agendastatus":{"type":"integer","description":"Agenda status","format":"int32","example":102560},"agendatype":{"type":"integer","description":"Agenda type","format":"int32","nullable":true,"example":62258},"begintijd":{"type":"string","description":"Begintijd","example":"2019-11-08 09:00:00"},"eindtijd":{"type":"string","description":"Eindtijd","example":"2019-11-08 15:30:00"},"extraInfo":{"type":"string","description":"Extra info","nullable":true},"inzage":{"type":"string","description":"Inzage","example":"Prive","enum":["Prive","Iedereen"]},"korteOmschrijving":{"type":"string","description":"KorteOmschrijving","nullable":true,"example":"Agenda1"},"locatie":{"type":"string","description":"Locatie","nullable":true,"example":"1056 SC  Amsterdam"},"medewerkerId":{"type":"integer","description":"MedewerkerId","format":"int32","example":100123},"medewerkerIdAanmaker":{"type":"integer","description":"MedewerkerIdAanmaker","format":"int32","nullable":true,"example":10009},"popupHerinnering":{"type":"string","description":"PopupHerinnering","nullable":true,"example":"T10_MINUTEN_ERVOOR","enum":["T10_MINUTEN_ERVOOR","T20_MINUTEN_ERVOOR","T30_MINUTEN_ERVOOR","T45_MINUTEN_ERVOOR","T1_UUR_ERVOOR","T2_UUR_ERVOOR","T4_UUR_ERVOOR","T1_DAG_ERVOOR"]},"projectcode":{"maxLength":10,"minLength":0,"type":"string","description":"Projectcode","nullable":true,"example":"AB101715"},"relatieId":{"type":"integer","description":"RelatieId","format":"int32","example":10009}},"description":"Inhoud van het request"},"AgendaOrTaskStatus":{"type":"object","properties":{"actief":{"type":"boolean"},"bedrijfscode":{"type":"string"},"entitytype":{"type":"integer","format":"int32"},"status":{"type":"string"},"systemid":{"type":"integer","format":"int32"},"tekstKleur":{"type":"string"},"volgorde":{"type":"integer","format":"int32"}}},"AgendaTakenRelatieV2":{"type":"object","properties":{"id":{"type":"integer","format":"int32","nullable":true},"type":{"type":"string","nullable":true}}},"AgendaType":{"type":"object","properties":{"achtergrondkleur":{"type":"string"},"actief":{"type":"boolean"},"bedrijfscode":{"type":"string"},"systemid":{"type":"integer","format":"int32"},"type":{"type":"string"},"volgorde":{"type":"integer","format":"int32","nullable":true}}},"AgendaUpdatePayloadV3":{"required":["afdelingscode","agendastatus","begintijd","eindtijd","medewerkerId"],"type":"object","properties":{"afdelingscode":{"maxLength":10,"minLength":0,"type":"string","description":"Code van het makelaarskantoor","example":"deptm1"},"afspraakGeheleDag":{"type":"boolean","description":"AfspraakGeheleDag","nullable":true,"example":false},"agendastatus":{"type":"integer","description":"Agenda status","format":"int32","example":102560},"agendatype":{"type":"integer","description":"Agenda type","format":"int32","nullable":true,"example":62258},"begintijd":{"type":"string","description":"Begintijd","example":"2019-11-08 09:00:00"},"eindtijd":{"type":"string","description":"Eindtijd","example":"2019-11-08 15:30:00"},"extraInfo":{"type":"string","description":"Extra info","nullable":true},"inzage":{"type":"string","description":"Inzage","nullable":true,"example":"Prive","enum":["Prive","Iedereen"]},"korteOmschrijving":{"type":"string","description":"KorteOmschrijving","nullable":true,"example":"Agenda1"},"locatie":{"type":"string","description":"Locatie","nullable":true,"example":"1056 SC  Amsterdam"},"medewerkerId":{"type":"integer","description":"MedewerkerId","format":"int32","example":100123},"popupHerinnering":{"type":"string","description":"PopupHerinnering","nullable":true,"example":"T10_MINUTEN_ERVOOR","enum":["T10_MINUTEN_ERVOOR","T20_MINUTEN_ERVOOR","T30_MINUTEN_ERVOOR","T45_MINUTEN_ERVOOR","T1_UUR_ERVOOR","T2_UUR_ERVOOR","T4_UUR_ERVOOR","T1_DAG_ERVOOR"]},"projectcode":{"maxLength":10,"minLength":0,"type":"string","description":"Projectcode","nullable":true,"example":"AB101715"},"relatieId":{"type":"integer","description":"RelatieId","format":"int32","example":10009}},"description":"Inhoud van het request"},"AgendaV2":{"type":"object","properties":{"afspraakGeheleDag":{"type":"boolean","nullable":true},"agendacode":{"type":"string"},"agendatype":{"type":"string","nullable":true},"bedrijfscode":{"type":"string","description":"Bedrijf, alle afdelingen vallen hieronder"},"bedrijfsrelatiecode":{"type":"string","description":"Code van het gekoppelde bedrijf","nullable":true},"begintijd":{"type":"string","format":"date-time"},"eindtijd":{"type":"string","format":"date-time"},"extraInfo":{"type":"string","nullable":true},"id":{"type":"integer","format":"int32"},"invoerdatum":{"type":"string","format":"date-time"},"korteOmschrijving":{"type":"string","nullable":true},"locatie":{"type":"string","nullable":true},"popupHerinnering":{"type":"string","nullable":true,"enum":["T10_MINUTEN_ERVOOR","T20_MINUTEN_ERVOOR","T30_MINUTEN_ERVOOR","T45_MINUTEN_ERVOOR","T1_UUR_ERVOOR","T2_UUR_ERVOOR","T4_UUR_ERVOOR","T1_DAG_ERVOOR"]},"project":{"$ref":"#/components/schemas/CalendarProject"},"relaties":{"type":"array","items":{"$ref":"#/components/schemas/AgendaTakenRelatieV2"}},"status":{"type":"string","nullable":true},"tijdstipLaatsteWijziging":{"type":"string","format":"date-time","nullable":true},"vrijgegevenMove":{"type":"boolean","nullable":true}}},"ApiSearchResultsAgendaV2":{"type":"object","properties":{"paginering":{"$ref":"#/components/schemas/PaginationInfo"},"resultaten":{"type":"array","items":{"$ref":"#/components/schemas/AgendaV2"}}},"description":"Zoekresultaten"},"BedrijfPayload":{"type":"object","allOf":[{"$ref":"#/components/schemas/RelatieCreatePayload"},{"type":"object","properties":{"bedrijfsnaam":{"minLength":1,"type":"string","description":"bedrijfsnaam"},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"BEDRIJF"}}}],"description":"Bedrijf payload data","required":["afdelingscode","bedrijfsnaam","email","relatiesoort"]},"CalendarProject":{"type":"object","properties":{"projectcode":{"type":"string","nullable":true},"type":{"type":"string","nullable":true,"enum":["ZOEKOPDRACHTEN","WONEN","NIEUWBOUW","BOUWTYPE","BOUWNUMMER","BOG"]}},"nullable":true},"ContactPersonPayload":{"type":"object","allOf":[{"$ref":"#/components/schemas/RelatieCreatePayload"},{"type":"object","properties":{"achternaam":{"minLength":1,"type":"string","description":"achternaam"},"companyId":{"minLength":1,"type":"string","description":"companyId"},"geslacht":{"type":"string","description":"geslacht","nullable":true,"enum":["M","V","O"]},"initialen":{"type":"string","description":"initialen","nullable":true},"land":{"type":"string","description":"land","nullable":true},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"CONTACTPERSOON"},"roepnaam":{"type":"string","description":"roepnaam","nullable":true},"titel":{"type":"string","description":"titel","nullable":true},"tussenvoegsel":{"type":"string","description":"tussenvoegsel","nullable":true}}}],"description":"Contact person payload data","required":["achternaam","afdelingscode","companyId","email","relatiesoort"]},"ErrorResponse":{"type":"object","properties":{"meldingen":{"type":"array","items":{"type":"string"}}},"description":"Foutmeldingen"},"PaginationInfo":{"type":"object","properties":{"totaalAantal":{"type":"integer","format":"int64"},"volgende":{"type":"string","format":"uri","nullable":true}},"description":"Pagineringsinformatie"},"ParticulierPayload":{"type":"object","allOf":[{"$ref":"#/components/schemas/RelatieCreatePayload"},{"type":"object","properties":{"achternaam":{"minLength":1,"type":"string","description":"achternaam"},"geslacht":{"type":"string","description":"geslacht","nullable":true,"enum":["M","V","O"]},"initialen":{"type":"string","description":"initialen","nullable":true},"land":{"type":"string","description":"land","nullable":true},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"PARTICULIER"},"roepnaam":{"type":"string","description":"roepnaam","nullable":true},"titel":{"type":"string","description":"titel","nullable":true},"tussenvoegsel":{"type":"string","description":"tussenvoegsel","nullable":true}}}],"description":"Particulier payload data","required":["achternaam","afdelingscode","email","relatiesoort"]},"RelatieCreatePayload":{"required":["afdelingscode","email","relatiesoort"],"type":"object","properties":{"accountmanager":{"type":"string","description":"accountmanager","nullable":true,"example":"accountManager"},"afdelingscode":{"minLength":1,"type":"string","description":"afdelingscode","example":"afdelingscode"},"email":{"minLength":1,"type":"string","description":"email","example":"ab@realworks.com"},"huisnummer":{"type":"string","description":"huisnummer","nullable":true,"example":"12"},"huisnummertoevoeging":{"type":"string","description":"huisnummertoevoeging","nullable":true,"example":"1"},"mobielTelefoonnummer":{"type":"string","description":"mobielTelefoonnummer","nullable":true,"example":"123-1331-122"},"postcode":{"type":"string","description":"postcode","nullable":true,"example":"112133"},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"BEDRIJF","enum":["BEDRIJF, CONTACTPERSOON, PARTICULIER"]},"straat":{"type":"string","description":"straat","nullable":true},"telefoonnummer":{"type":"string","description":"telefoonnummer","nullable":true,"example":"123-1331-122"},"woonplaats":{"type":"string","description":"woonplaats","nullable":true}},"description":"Relatie create payload data"},"SyncWritePathReply":{"type":"object","properties":{"entityId":{"type":"integer","description":"ID van de nieuw gemaakte/bijgewerkte entiteit","format":"int64","nullable":true},"entityKey":{"type":"string","description":"Key van de nieuw gemaakte/bijgewerkte entiteit","nullable":true},"entityType":{"type":"string","description":"Entiteitstype gemaakt/bijgewerkt","nullable":true},"foutmeldingen":{"type":"array","nullable":true,"items":{"type":"string"}},"ontvangstId":{"type":"string","description":"Identifier zoals mogelijk opgegeven door de client, anders gegenereerd. UUID-4"},"result":{"type":"string","enum":["OK","ERROR","EXCEPTION","IN_PROGRESS","WAITING_FOR_S3_UPLOAD"]}}}},"securitySchemes":{"rwauth":{"in":"header","name":"Authorization","type":"apiKey"}}}}