{ "openapi": "3.1.0", "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "info": { "title": "Mission Work API", "version": "v1", "description": "# Mission Work anbinden\n\nMit der Mission Work API verbinden Sie Ihre Systeme mit Ihrem Recruiting in Mission Work. Sie können Kandidaten, Kundenunternehmen und Stellen verwalten, Bewerbungen bearbeiten und Änderungen über Webhooks empfangen.\n\nDie Basisadresse ist `https://api.work.mission-personal.org/v1`. Die folgende Anleitung beschreibt Einrichtung und typische Abläufe. Die anschließende API-Referenz enthält die Parameter und Antworten jeder Operation.\n\n## API-Zugang und erster Aufruf\n\n1. Öffnen Sie **Admin Settings → Zugangsverwaltung → API-Zugänge** in Mission Work.\n2. Legen Sie einen Zugang an und wählen Sie eine Rolle mit den benötigten Berechtigungen.\n3. Speichern Sie den einmal angezeigten API-Schlüssel sicher auf Ihrem Server.\n\nSenden Sie den Schlüssel bei jedem Aufruf im Header `Authorization: Bearer `. Verwenden Sie HTTPS und halten Sie den Schlüssel aus URLs, öffentlich zugänglichem Code und Protokollen heraus.\n\nMit diesem Aufruf prüfen Sie den Schlüssel und sehen die zugewiesene Organisation und die aktuellen Berechtigungen:\n\n```sh\ncurl --fail-with-body \\\n -H \"Authorization: Bearer $MISSION_WORK_API_KEY\" \\\n https://api.work.mission-personal.org/v1/access-contexts/current\n```\n\nDer Aufruf funktioniert auch, wenn dem Zugang noch keine Berechtigungen für Datensätze zugewiesen sind. Für weitere Operationen benötigt die Rolle die in der Referenz angegebenen Rechte. Eine Rollenänderung wirkt ab dem nächsten Aufruf.\n\nSie können Schlüssel widerrufen oder wechseln. Für einen Wechsel dürfen bis zu zwei Schlüssel gleichzeitig gültig sein: neuen Schlüssel erstellen, Ihre Integration umstellen, bisherigen Schlüssel widerrufen. Der API-Zugang und seine Webhooks bleiben dabei erhalten.\n\n## Ressourcen und IDs\n\n| Ressource | Pfad | Bedeutung |\n|---|---|---|\n| Kandidaten | `/candidates` | Kandidatenprofile mit Kontaktdaten und benutzerdefinierten Feldern |\n| Unternehmen | `/companies` | Ihre Kundenunternehmen in Mission Work |\n| Ansprechpartner | `/contacts` | Kontakte eines Kundenunternehmens |\n| Stellen | `/jobs` | Eigene Stellen und verfügbare Kundenstellen |\n| Bewerbungen | `/hiring-process/applications` | Zuordnung eines Kandidaten zu einer Stelle mit Bewerbungsprozess |\n| Notizen | `/notes` | Interne Notizen mit Zuordnungen zu Datensätzen |\n| Aufgaben | `/tasks` | Manuell angelegte Todos mit Checkliste |\n| Anrufe | `/calls` | Protokollierte Anrufe |\n\nSpeichern Sie die zurückgelieferten IDs in Ihrer Integration. Sie sind UUIDs und verbinden Ihre Datensätze dauerhaft mit denen in Mission Work. `companyId` bezeichnet das Kundenprofil; `memberId` bezeichnet einen Benutzer innerhalb Ihrer Organisation und wird beispielsweise für Zuständigkeiten verwendet.\n\nE-Mail-Adressen und Telefonnummern dienen als Suchfilter. Eine Suche kann mehrere Kandidaten liefern und aktualisiert oder vereinigt keine Datensätze automatisch. Telefonnummern werden im internationalen Format mit führendem `+` angegeben, zum Beispiel `+49301234567`.\n\n## Felder lesen und ändern\n\n`GET /record-schemas/{resourceType}` beschreibt die Felder für `candidates`, `companies` oder `jobs`: Datentypen, Pflichtangaben, Auswahloptionen und Unterstützung durch die API. Benutzerdefinierte Werte werden in `customFields` unter der jeweiligen Feld-ID übermittelt.\n\nBei `PATCH` ändern Sie nur die mitgesendeten Felder. Weggelassene Felder bleiben unverändert. `null` leert einen Wert, wenn das Feld dies erlaubt. Übergeben Sie die Revision des zuvor gelesenen Datensatzes als `expectedRevision`. Bei `409 revision_conflict` lesen Sie den aktuellen Stand und prüfen Ihre Änderung erneut.\n\nSchreiboperationen liefern einen Ergebnisbeleg mit Ressourcen-ID, Ressourcenadresse und gegebenenfalls Revision. Rufen Sie die Ressourcenadresse auf, um die aktuellen Angaben zu lesen.\n\nDer Kandidatenread enthält `links.profileUpdate`. Dieser Link führt Kandidaten zur Anmeldung für die Aktualisierung ihres eigenen Profils.\n\n## Schreibaufträge sicher wiederholen\n\nSenden Sie für jeden neuen Schreibauftrag eine UUID im Header `Idempotency-Key`. Bewahren Sie diese Kennung auf, bis der Ausgang feststeht. Vorschauoperationen benötigen keinen Idempotenzschlüssel.\n\nGeht die Antwort verloren oder tritt ein vorübergehender Fehler auf, wiederholen Sie dieselbe Anfrage mit demselben Schlüssel. Mission Work führt einen bereits erfolgreich gespeicherten Auftrag nicht erneut aus und liefert dessen Ergebnisbeleg zurück.\n\n| Antwort | Nächster Schritt |\n|---|---|\n| `409 idempotency_conflict` | Der Schlüssel wurde für andere Eingaben verwendet. Prüfen Sie Ihren Auftrag. Ein tatsächlich neuer Auftrag benötigt einen neuen Schlüssel. |\n| `409 request_in_progress` | Der Auftrag wird noch verarbeitet. Warten Sie den angegebenen Zeitraum ab und wiederholen Sie dieselbe Anfrage mit demselben Schlüssel. |\n\nErfolgreiche Aufträge werden **30 Tage** für die Wiederholung gespeichert. Danach ist der Schutz vor erneuter Ausführung nicht mehr garantiert. Prüfen Sie bei älteren Aufträgen den Datensatz anhand seiner gespeicherten Mission-Work-ID, bevor Sie einen neuen Auftrag starten.\n\n## Dateien hochladen\n\nUploads verwenden `multipart/form-data` mit genau einer Datei unter `file` und einem Textfeld `metadata`, das ein JSON-Objekt enthält. Die Metadaten umfassen die erwartete Revision und, bei Dokumentfeldern, das Ziel der Datei. Die Datei darf höchstens **10 MiB (10.485.760 Bytes)** groß sein. Lebensläufe werden als PDF, DOCX, TXT oder Markdown unterstützt. Die Referenz beschreibt die Metadaten der jeweiligen Operation.\n\nLaden Sie einen Profillebenslauf mit `PUT /candidates/{candidateId}/resume` hoch. Für weitere Kandidatendokumente verwenden Sie ein unterstütztes Dokumentfeld unter `POST /candidates/{candidateId}/documents`. Nach der Übernahme kann die Verarbeitung der Datei im Hintergrund weiterlaufen.\n\n## Bewerbungen und Stellen verwalten\n\nEine Bewerbung verbindet einen vorhandenen Kandidaten mit einer Stelle. Rufen Sie vor der Anlage `POST /hiring-process/applications/preview` auf und prüfen Sie Fehler, Warnungen und erforderliche Bestätigungen. Anschließend senden Sie die Anlage mit den geprüften Angaben und einer angeforderten Bestätigung.\n\nFür weitere Prozessschritte liefert `GET /hiring-process/applications/{applicationId}/actions` die angebotenen Aktionen. Prüfen Sie die gewählte Aktion über ihre Vorschau und führen Sie sie mit der aktuellen Stage-Revision aus. So werden zum Beispiel Prüfungen abgeschlossen, ein Interview vorbereitet oder eine Bewerbung zurückgezogen. Die Voraussetzungen ergeben sich aus Ihrem konfigurierten Bewerbungsprozess.\n\nArbeitgeber sehen die für sie freigegebenen Bewerbungen. Wird eine Freigabe entzogen, ist die Bewerbung für diesen Zugang nicht mehr verfügbar. Das Bewerbungsleserecht umfasst den aktuellen Bewerbungslebenslauf; dessen Metadaten liefern eine `downloadUrl`.\n\nStellen werden über `/jobs/{jobId}/closure` geschlossen. Rufen Sie zuvor die zugehörige Vorschau auf und übergeben Sie die erforderliche Bestätigung. Ergänzende Bemerkungen können Sie als Notiz anlegen.\n\n## Listen und Pagination\n\nPaginierte Ressourcenlisten liefern `items` und `nextCursor`. Mit `limit` wählen Sie die Seitengröße: standardmäßig 50, maximal 100 Einträge. Wenn `nextCursor` gesetzt ist, übergeben Sie ihn unverändert als `cursor` im nächsten Aufruf und verwenden dieselben Filter. Bei `nextCursor: null` ist die Liste vollständig gelesen.\n\n## Limits und Fehlerbehandlung\n\n| Limit | Requests pro Minute |\n|---|---|\n| Pro API-Schlüssel | 120 |\n| Pro Organisation, über alle Schlüssel hinweg | 600 |\n| Pro Client-IP | 600 |\n| Uploads pro API-Schlüssel, zusätzlich zum allgemeinen Limit | 10 |\n\nBei `429` warten Sie die im Header `Retry-After` angegebene Zeit ab.\n\nFehlerantworten haben das Format `{ \"error\": { \"code\": \"…\", \"message\": \"…\" } }`. Verwenden Sie `error.code` für Ihre Fehlerbehandlung; `message` erläutert den Fehler. Je nach Fehler enthält `error.details` weitere Hinweise. Geben Sie bei Supportanfragen den Antwortheader `x-request-id` an.\n\n| Status | Bedeutung und Vorgehen |\n|---|---|\n| `400` | Anfrage oder Cursor ungültig. Parameter prüfen. |\n| `401` | API-Schlüssel fehlt oder ist ungültig. Schlüssel prüfen. |\n| `403` | Erforderliche Berechtigung fehlt. Rolle des API-Zugangs prüfen. |\n| `404` | Datensatz ist nicht vorhanden oder für den Zugang nicht verfügbar. |\n| `409` | Konflikt, laufender Auftrag oder notwendige Bestätigung. Den konkreten Fehlercode beachten. |\n| `410 resync_required` | Ereigniscursor nicht mehr gültig. Vollsynchronisierung neu starten. |\n| `413` / `415` | Datei zu groß oder Dateityp nicht unterstützt. Uploadvorgaben prüfen. |\n| `422` | Eingaben können nicht übernommen werden. Feldhinweise prüfen und Eingaben korrigieren. |\n| `500` / `503` | Serverfehler oder vorübergehende Nichtverfügbarkeit. Erneut versuchen; bei Writes denselben Idempotenzschlüssel verwenden. |\n\n## Webhooks einrichten\n\nÖffnen Sie den gewünschten API-Zugang in Mission Work und wählen Sie im Abschnitt **Webhooks** die Aktion **Webhook hinzufügen**. Geben Sie einen Namen und eine öffentliche HTTPS-Zieladresse an und wählen Sie die gewünschten Ereignisse. Der API-Zugang benötigt die passenden Leserechte.\n\nSpeichern Sie das einmal angezeigte Signaturgeheimnis bei Ihrem Empfänger. Es dient zur Prüfung eingehender Webhooks und ist unabhängig vom API-Schlüssel für REST-Aufrufe. Mit **Testereignis senden** prüfen Sie Ihre Einrichtung.\n\nPro API-Zugang sind höchstens fünf Webhooks möglich; pausierte Webhooks zählen mit.\n\n## Ereignisse verarbeiten\n\nWebhooks enthalten Ereignis-ID, Typ, Zeitangaben und eine Ressourcenreferenz. Über `resource.url` lesen Sie anschließend den aktuellen Datensatz. Beispielsweise weist `candidate.updated` auf eine Änderung des Kandidaten hin. Änderungen werden unabhängig davon gemeldet, ob sie über die API oder in Mission Work vorgenommen wurden.\n\nDie Ereignisse enthalten keine Kopie des Datensatzes. Beim Abruf kann dieser bereits erneut geändert worden sein. `removed` bedeutet, dass der Datensatz für den API-Zugang nicht mehr verfügbar ist, etwa nach einer Löschung oder einem Freigabeentzug. Aktualisieren Sie in diesem Fall Ihren lokalen Bestand entsprechend. `webhook.test` enthält keine Ressourcenreferenz.\n\nIhr Empfänger sollte:\n\n1. Die Signatur anhand der unveränderten Request-Bytes und der drei `webhook-*`-Header prüfen.\n2. Zeitstempel mit mehr als fünf Minuten Abweichung ablehnen.\n3. Das Ereignis dauerhaft zur Verarbeitung vormerken und Duplikate anhand von `webhook-id` erkennen.\n4. Zügig mit `2xx` antworten und den Datensatz anschließend im Hintergrund abrufen.\n\nZustellungen können mehrfach und in anderer Reihenfolge eintreffen. Halten Sie die Uhren Ihrer Systeme synchron und verwenden Sie Ereignisse als Anlass, den aktuellen Zustand zu lesen.\n\n## Signaturen prüfen und Geheimnisse wechseln\n\nDie Signatur folgt dem Protokoll **Standard Webhooks**:\n\n| Header | Inhalt |\n|---|---|\n| `webhook-id` | Stabile Ereignis-ID, auch bei Wiederholungen |\n| `webhook-timestamp` | Unixzeit in Sekunden, bei jedem Zustellversuch erneuert |\n| `webhook-signature` | Eine oder mehrere durch Leerzeichen getrennte Signaturen im Format `v1,` |\n\nSigniert werden das UTF-8-Präfix `id.timestamp.` und der unveränderte Requestbody mit HMAC-SHA256. Das Geheimnis beginnt mit `whsec_`; der folgende Teil ist Base64-kodiert. Verwenden Sie vorzugsweise eine Standard-Webhooks-Bibliothek, die Signaturvergleich und Zeitstempelprüfung übernimmt. Verändern oder serialisieren Sie den Body vor der Prüfung nicht erneut.\n\nBei einem Wechsel des Signaturgeheimnisses bleibt das bisherige Geheimnis 24 Stunden zusätzlich gültig. Währenddessen werden beide Signaturen mitgesendet. Stellen Sie Ihren Empfänger auf das neue Geheimnis um und widerrufen Sie das bisherige bei Bedarf vorzeitig. Ein weiterer Wechsel ist möglich, sobald diese Übergangszeit beendet oder das bisherige Geheimnis widerrufen ist.\n\n## Zustellung und Wiederholung\n\nDas Timeout pro Zustellversuch beträgt 15 Sekunden. Mission Work wiederholt Netzwerkfehler sowie Antworten mit `408`, `429` oder `5xx`. Es gibt höchstens acht Versuche innerhalb von ungefähr 24 Stunden mit zunehmenden Abständen. Ein gültiger `Retry-After`-Header wird berücksichtigt. Andere `4xx` beenden die Zustellung; Weiterleitungen werden nicht verfolgt.\n\nIm Zustellungsverlauf sehen Sie den letzten Status und können fehlgeschlagene Zustellungen erneut senden. Die Ereignis-ID bleibt dabei gleich.\n\nPausieren stoppt neue Mitteilungen und unterdrückt ausstehende Zustellungen. Nach dem Fortsetzen werden zukünftige Ereignisse zugestellt; ausgelassene Ereignisse werden nicht automatisch nachgesendet. Das gilt auch nach Deaktivierung und Reaktivierung des API-Zugangs. Nutzen Sie zum Nachholen die Ereignis-API oder senden Sie eine geeignete Zustellung ausdrücklich erneut.\n\n## Änderungen nachholen und vollständig synchronisieren\n\nDie Ereignis-API hält Änderungen **30 Tage** abrufbar. Lesen Sie `GET /events` mit einem gespeicherten Cursor oder starten Sie mit `since`; dieser Zeitpunkt bezieht sich auf die Veröffentlichung des Ereignisses. Übernehmen Sie `nextCursor` auch dann, wenn die Antwort keine sichtbaren Ereignisse enthält. Speichern Sie ihn, nachdem Sie die Seite verarbeitet haben. `hasMore: true` bedeutet, dass Sie die nächste Seite sofort abrufen können. Bei `hasMore: false` ist der Abgleich vorerst aktuell; verwenden Sie den gespeicherten Cursor beim nächsten Abruf.\n\nFür eine Vollsynchronisierung:\n\n1. Mit `GET /events/checkpoint` einen Startcursor holen.\n2. Die benötigten Ressourcenlisten vollständig lesen.\n3. Ereignisse ab dem Startcursor nachziehen und den neuen Cursor speichern.\n\nDamit erfassen Sie auch Änderungen während des Listenabrufs. Bei `410 resync_required` starten Sie diesen Ablauf erneut. Ein Cursor kann nach Ablauf der Aufbewahrungsfrist oder nach Änderungen am API-Zugang beziehungsweise seiner Rolle ungültig werden. Ein reiner API-Schlüsselwechsel erhält ihn.\n\n## API-Version und Referenz\n\nDie Pfade unter `/v1` gehören zur API-Version 1. Feldnamen, Enumwerte und Pfade sind in der deutschen und englischen Referenz identisch. Die OpenAPI-Datei können Sie über **OpenAPI JSON** herunterladen.\n\n## Beispiel: Kandidat und Lebenslauf\n\nSie benötigen Node.js, curl, jq und einen API-Zugang mit Kandidatenverwaltung. Speichern Sie den folgenden JSON-Block als `candidate.json` und legen Sie `resume.pdf` bereit. Passen Sie Kandidatenangaben, Herkunft und Verarbeitungszweck an Ihren Anwendungsfall an.\n\n```sh\nexport WORK_API_ORIGIN=\"https://api.work.mission-personal.org\"\n# MISSION_WORK_API_KEY: value from your server's secret store.\nexport CREATE_REQUEST_ID=\"$(node -e 'console.log(crypto.randomUUID())')\"\n```\n\n\n```json\n{\n \"firstName\": \"Robin\",\n \"lastName\": \"Example\",\n \"email\": \"robin@example.com\",\n \"captureOrigin\": {\n \"sourceDescription\": \"Application submitted through a careers site\",\n \"limitedProcessingBasis\": \"Candidate requested this application\"\n }\n}\n```\n\n```sh\ncurl --fail-with-body -X POST \"$WORK_API_ORIGIN/v1/candidates\" \\\n -H \"Authorization: Bearer $MISSION_WORK_API_KEY\" \\\n -H \"Idempotency-Key: $CREATE_REQUEST_ID\" -H 'Content-Type: application/json' \\\n --data-binary @candidate.json > candidate-receipt.json\nexport CANDIDATE_ID=\"$(jq -r '.resource.id' candidate-receipt.json)\"\ncurl --fail-with-body -H \"Authorization: Bearer $MISSION_WORK_API_KEY\" \\\n \"$WORK_API_ORIGIN/v1/candidates/$CANDIDATE_ID\" > candidate-current.json\njq '{expectedRevision: .revision}' candidate-current.json > resume-metadata.json\nexport RESUME_REQUEST_ID=\"$(node -e 'console.log(crypto.randomUUID())')\"\ncurl --fail-with-body -X PUT \"$WORK_API_ORIGIN/v1/candidates/$CANDIDATE_ID/resume\" \\\n -H \"Authorization: Bearer $MISSION_WORK_API_KEY\" \\\n -H \"Idempotency-Key: $RESUME_REQUEST_ID\" \\\n -F 'metadata= application-preview-request.json\ncurl --fail-with-body -X POST \"$WORK_API_ORIGIN/v1/hiring-process/applications/preview\" \\\n -H \"Authorization: Bearer $MISSION_WORK_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @application-preview-request.json > application-preview.json\n```\n\n```sh\n# Run only after reviewing the returned preview and explicitly accepting its effects.\njq --arg fingerprint \"$CONFIRMED_PREVIEW_FINGERPRINT\" \\\n '. + {confirmation:{previewFingerprint:$fingerprint}}' application-preview-request.json > application-request.json\nexport APPLICATION_REQUEST_ID=\"$(node -e 'console.log(crypto.randomUUID())')\"\ncurl --fail-with-body -X POST \"$WORK_API_ORIGIN/v1/hiring-process/applications\" \\\n -H \"Authorization: Bearer $MISSION_WORK_API_KEY\" \\\n -H \"Idempotency-Key: $APPLICATION_REQUEST_ID\" -H 'Content-Type: application/json' \\\n --data-binary @application-request.json > application-receipt.json\nexport APPLICATION_ID=\"$(jq -r '.resource.id' application-receipt.json)\"\ncurl --fail-with-body -H \"Authorization: Bearer $MISSION_WORK_API_KEY\" \\\n \"$WORK_API_ORIGIN/v1/hiring-process/applications/$APPLICATION_ID/actions\"\n```\n\nPrüfen Sie `errors`, Warnungen und die zurückgegebene Bestätigung. Setzen Sie `CONFIRMED_PREVIEW_FINGERPRINT` ausschließlich nach ausdrücklicher Zustimmung auf den gelieferten Fingerprint. Bei Fehlern wird nicht angelegt. Liefert die Vorschau keine notwendige Bestätigung, lassen Sie `confirmation` weg.\n\nFür weitere Prozesshandlungen wählen Sie eine aktuell angebotene Aktion aus `GET .../actions`. Senden Sie `action`, `expectedStageRevision` und deren typisierte `inputs` zunächst an `POST .../actions/preview`, danach mit der notwendigen Bestätigung und einem neuen Idempotenzschlüssel an `POST .../actions`. Welche Aktionen möglich sind, hängt von der aktuellen Prozessphase ab.\n\n## Beispiel: Signaturbibliothek\n\nInstallieren Sie `standardwebhooks` in Ihrem Empfängerprojekt. Der folgende Ausschnitt gehört in Ihren HTTP-Handler. `rawBody` sind die unverändert als UTF-8 gelesenen Requestbytes; `headers` enthält die drei `webhook-*`-Header. Ersetzen Sie `queue.insertOnce` durch Ihre eigene dauerhafte Verarbeitung mit Duplikaterkennung. Ungültige Signaturen führen zu einer Fehlerantwort und dürfen nichts einreihen.\n\n```ts\nimport { Webhook } from \"standardwebhooks\"\n\nconst verifier = new Webhook(process.env.WORK_WEBHOOK_SECRET!)\n\nasync function receiveWebhook(rawBody: string, headers: Record) {\n // Throws for invalid signatures or timestamps outside the five-minute tolerance.\n const event = verifier.verify(rawBody, headers) as {\n id: string\n type: string\n resource?: { url: string }\n }\n // Your persistent queue must enforce uniqueness on event.id. Commit before returning 204.\n await queue.insertOnce(event.id, event)\n return 204\n}\n```\n\nDie Hintergrundverarbeitung liest für fachliche Ereignisse `new URL(event.resource.url, WORK_API_ORIGIN)` mit dem Bearer-Schlüssel. `webhook.test` benötigt keinen REST-Read. `removed` entfernt die lokale Referenz; ein späterer GET kann bereits `404` liefern. Antworten Sie erst nach dauerhaftem Vormerken erfolgreich, warten Sie dafür aber nicht auf den REST-Read.\n" }, "servers": [ { "url": "/" } ], "paths": { "/v1/access-contexts/current": { "get": { "operationId": "getCurrentAccessContext", "summary": "Aktuellen API-Zugang prüfen", "description": "Zeigt die Organisation, den API-Zugang und seine aktuellen Berechtigungen. Verwenden Sie diesen Aufruf, um Ihren Schlüssel und die zugewiesenen Rechte zu prüfen.", "tags": [ "Access" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Aktueller Zugriffskontext", "content": { "application/json": { "schema": { "type": "object", "properties": { "organization": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "type": { "type": "string", "enum": [ "recruiting_agency", "employer" ] } }, "required": [ "id", "name", "type" ], "additionalProperties": false }, "membershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "grants": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 3, "maxLength": 128, "pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*(?:\\.[a-z][a-z0-9]*(?:_[a-z0-9]+)*)+$" }, "level": { "type": "string", "enum": [ "view", "manage" ] }, "scope": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$" }, { "type": "null" } ] } }, "required": [ "key", "level", "scope" ], "additionalProperties": false } } }, "required": [ "organization", "membershipId", "name", "grants" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/candidates": { "get": { "operationId": "listCandidates", "summary": "Kandidaten auflisten", "description": "Listet Kandidaten mit Cursorpagination auf. Suchen Sie nach Namen oder filtern Sie nach einer E-Mail-Adresse oder Telefonnummer. Die Suche nach Kontaktdaten kann mehrere Treffer liefern.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } }, { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } }, { "name": "phone", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^\\+[1-9]\\d{6,14}$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "firstName": { "type": "string" }, "lastName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "archived": { "type": "boolean" } }, "required": [ "id", "firstName", "lastName", "email", "phone", "archived" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "post": { "operationId": "createCandidate", "summary": "Kandidat anlegen", "description": "Legt einen Kandidaten mit Kontaktdaten und optionalen benutzerdefinierten Feldern an. Geben Sie unter captureOrigin die Herkunft und den Verarbeitungszweck an. Die Antwort enthält ID, Ressourcenadresse und Revision des angelegten Kandidaten.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 100 }, "lastName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "pattern": "^\\+[1-9]\\d{6,14}$" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "willingToRelocate": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "relevantExperienceYears": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expectedSalary": { "anyOf": [ { "type": "object", "properties": { "amount": { "type": "string" }, "currency": { "type": "string" }, "period": { "type": "string" } }, "required": [ "amount", "currency", "period" ], "additionalProperties": false }, { "type": "null" } ] }, "noticePeriodDays": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availableFrom": { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "captureOrigin": { "type": "object", "properties": { "sourceDescription": { "type": "string", "minLength": 1, "maxLength": 2000 }, "limitedProcessingBasis": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "sourceDescription", "limitedProcessingBasis" ], "additionalProperties": false } }, "required": [ "firstName", "captureOrigin" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "manage" } } }, "/v1/candidates/{candidateId}": { "get": { "operationId": "getCandidate", "summary": "Kandidat lesen", "description": "Liefert die aktuellen Kandidatenangaben, benutzerdefinierte Felder und die Revision für Änderungen. links.profileUpdate führt zur Anmeldung für die Profilaktualisierung.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 100 }, "lastName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "pattern": "^\\+[1-9]\\d{6,14}$" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "willingToRelocate": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "relevantExperienceYears": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expectedSalary": { "anyOf": [ { "type": "object", "properties": { "amount": { "type": "string" }, "currency": { "type": "string" }, "period": { "type": "string" } }, "required": [ "amount", "currency", "period" ], "additionalProperties": false }, { "type": "null" } ] }, "noticePeriodDays": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availableFrom": { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "string" }, "links": { "type": "object", "properties": { "profileUpdate": { "type": "string", "format": "uri" } }, "required": [ "profileUpdate" ], "additionalProperties": false } }, "required": [ "id", "revision", "links" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "patch": { "operationId": "updateCandidate", "summary": "Kandidat bearbeiten", "description": "Ändert die angegebenen Kandidatenfelder. Nicht übermittelte Felder bleiben unverändert; null leert ein Feld, sofern es dies erlaubt. Übergeben Sie die zuletzt gelesene Revision als expectedRevision.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 100 }, "lastName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "pattern": "^\\+[1-9]\\d{6,14}$" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "willingToRelocate": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "relevantExperienceYears": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expectedSalary": { "anyOf": [ { "type": "object", "properties": { "amount": { "type": "string" }, "currency": { "type": "string" }, "period": { "type": "string" } }, "required": [ "amount", "currency", "period" ], "additionalProperties": false }, { "type": "null" } ] }, "noticePeriodDays": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availableFrom": { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "expectedRevision": { "type": "string", "minLength": 1, "maxLength": 4096 } }, "required": [ "expectedRevision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "manage" } } }, "/v1/candidates/{candidateId}/erasure/preview": { "post": { "operationId": "previewCandidateErasure", "summary": "Löschung personenbezogener Daten prüfen", "description": "Zeigt die Auswirkungen der Löschung personenbezogener Kandidatendaten. Prüfen Sie betroffene Datensätze und Hinweise, bevor Sie die Löschung bestätigen. Dieser Aufruf ändert keine Daten.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Aktuelle Folgen und Bestätigung", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "blocked" }, "action": { "type": "string", "enum": [ "archive", "reactivate", "erase", "close", "handoff" ] }, "blockers": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "active_candidacies", "open_jobs", "job_open", "employer_access_missing", "already_erased", "responsibility_changed" ] } }, "effects": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "erase_contents", "end_work", "handoff", "preserve", "hide", "restore" ] }, "resource": { "type": "string", "enum": [ "candidate", "candidacy", "job", "customer", "employer", "invitation" ] }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "resource", "count" ], "additionalProperties": false } } }, "required": [ "kind", "action", "blockers", "effects" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "action_preview" }, "action": { "type": "string", "enum": [ "archive", "reactivate", "erase", "close", "handoff" ] }, "effects": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "erase_contents", "end_work", "handoff", "preserve", "hide", "restore" ] }, "resource": { "type": "string", "enum": [ "candidate", "candidacy", "job", "customer", "employer", "invitation" ] }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "resource", "count" ], "additionalProperties": false } }, "confirmation": { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "warnings": { "readOnly": true, "maxItems": 1500, "type": "array", "items": { "not": {} } } }, "required": [ "previewFingerprint", "warnings" ], "additionalProperties": false } }, "required": [ "kind", "action", "effects", "confirmation" ], "additionalProperties": false } ] } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "manage" } } }, "/v1/candidates/{candidateId}/erasure": { "post": { "operationId": "commitCandidateErasure", "summary": "Personenbezogene Daten löschen", "description": "Löscht die personenbezogenen Kandidatendaten mit der erforderlichen Bestätigung aus der Vorschau. Hat sich der relevante Stand geändert, müssen Sie eine neue Vorschau abrufen.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "confirmation": { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "previewFingerprint" ], "additionalProperties": false } }, "required": [ "confirmation" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Bestätigte Ausführung", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "manage" } } }, "/v1/candidates/{candidateId}/documents": { "get": { "operationId": "listCandidateDocuments", "summary": "Dokumente auflisten", "description": "Listet die Dokumente auf, auf die Ihr API-Zugang beim angegebenen Kandidaten zugreifen darf. Enthält Metadaten und die Zuordnung zum jeweiligen Dokumentfeld.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "fileName": { "type": "string" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "target": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "resume" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "custom" }, "fieldId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "entryId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": [ "kind", "fieldId", "entryId" ], "additionalProperties": false } ] } }, "required": [ "id", "fileName", "mediaType", "sizeBytes", "target" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "post": { "operationId": "uploadCandidateDocument", "summary": "Dokumentfeld befüllen", "description": "Lädt eine Datei in ein unterstütztes Dokumentfeld des Kandidaten hoch. Senden Sie file und die JSON-Metadaten als multipart/form-data. Das Feldschema beschreibt die verfügbaren Dokumentfelder.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "metadata": { "type": "string", "description": "JSON: {\"expectedRevision\":\"...\",\"target\":{\"kind\":\"custom\",\"fieldId\":\"...\",\"entryId\":null}}" }, "file": { "type": "string", "format": "binary" } }, "required": [ "metadata", "file" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "413": { "description": "Upload überschreitet die Größenbegrenzung (payload_too_large).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Datei- oder Inhaltstyp wird nicht unterstützt (unsupported_media_type).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "manage" } } }, "/v1/candidates/{candidateId}/documents/{documentId}": { "get": { "operationId": "getCandidateDocument", "summary": "Dokumentmetadaten lesen", "description": "Liefert die Metadaten eines dem Kandidaten zugeordneten Dokuments. Verwenden Sie den zugehörigen content-Endpunkt, um die Datei herunterzuladen.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "documentId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "fileName": { "type": "string" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "target": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "resume" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "custom" }, "fieldId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "entryId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": [ "kind", "fieldId", "entryId" ], "additionalProperties": false } ] } }, "required": [ "id", "fileName", "mediaType", "sizeBytes", "target" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } } }, "/v1/candidates/{candidateId}/documents/{documentId}/content": { "get": { "operationId": "getCandidateDocumentContent", "summary": "Dokument herunterladen", "description": "Lädt eine dem Kandidaten zugeordnete Datei herunter. Dokument-ID und Kandidatenzuordnung müssen zusammenpassen.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "documentId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Inhalt nicht mehr verfügbar oder Synchronisierung neu beginnen (resync_required).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } } }, "/v1/candidates/{candidateId}/resume": { "get": { "operationId": "getCandidateResume", "summary": "Lebenslauf lesen", "description": "Liefert die Metadaten des aktuellen Profillebenslaufs. Ohne hinterlegten Lebenslauf antwortet der Endpunkt mit 404. Die Revision für einen Upload erhalten Sie beim Lesen des Kandidaten.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "fileName": { "type": "string" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "target": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "resume" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "custom" }, "fieldId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "entryId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": [ "kind", "fieldId", "entryId" ], "additionalProperties": false } ] } }, "required": [ "id", "fileName", "mediaType", "sizeBytes", "target" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "put": { "operationId": "putCandidateResume", "summary": "Lebenslauf ersetzen", "description": "Lädt einen neuen Profillebenslauf hoch und ersetzt die bisherige Zuordnung. Senden Sie die Datei und expectedRevision als multipart/form-data. Die Revision erhalten Sie beim Lesen des Kandidaten.", "tags": [ "candidates" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "metadata": { "type": "string", "description": "JSON: {\"expectedRevision\":\"...\"}" }, "file": { "type": "string", "format": "binary" } }, "required": [ "metadata", "file" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "413": { "description": "Upload überschreitet die Größenbegrenzung (payload_too_large).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Datei- oder Inhaltstyp wird nicht unterstützt (unsupported_media_type).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "manage" } } }, "/v1/companies": { "get": { "operationId": "listCompanies", "summary": "Unternehmen auflisten", "description": "Listet Kundenunternehmen auf. Verwenden Sie query für die Namenssuche und nextCursor für weitere Ergebnisse.", "tags": [ "companies" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } }, { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "archived": { "type": "boolean" } }, "required": [ "id", "name", "archived" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.customers", "level": "view" } }, "post": { "operationId": "createCompany", "summary": "Unternehmen anlegen", "description": "Legt ein Kundenunternehmen mit den angegebenen Unternehmensdaten und benutzerdefinierten Feldern an. Pflichtfelder ergeben sich aus der Feldkonfiguration Ihrer Organisation.", "tags": [ "companies" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "website": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "careerPage": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employeeCountRange": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "additionalAddressLine": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "defaultLocale": { "type": "string", "enum": [ "de", "en" ] }, "timeZone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "name", "defaultLocale", "timeZone" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.customers", "level": "manage" } } }, "/v1/companies/{companyId}": { "get": { "operationId": "getCompany", "summary": "Unternehmen lesen", "description": "Liefert die aktuellen Angaben und benutzerdefinierten Felder eines Kundenunternehmens sowie die Revision für Änderungen. companyId ist die ID des Kundenprofils in Mission Work.", "tags": [ "companies" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "companyId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "website": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "careerPage": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employeeCountRange": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "additionalAddressLine": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "string" } }, "required": [ "id", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.customers", "level": "view" } }, "patch": { "operationId": "updateCompany", "summary": "Unternehmen bearbeiten", "description": "Ändert die angegebenen Unternehmensfelder. Nicht übermittelte Felder bleiben unverändert. Übergeben Sie die zuletzt gelesene Revision als expectedRevision.", "tags": [ "companies" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "companyId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "website": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "careerPage": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employeeCountRange": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "additionalAddressLine": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "expectedRevision": { "type": "string", "minLength": 1, "maxLength": 4096 } }, "required": [ "expectedRevision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.customers", "level": "manage" } } }, "/v1/contacts": { "get": { "operationId": "listContacts", "summary": "Ansprechpartner auflisten", "description": "Listet Ansprechpartner auf, die für Ihre Organisation verfügbar sind. Filtern Sie mit companyId nach einem Kundenunternehmen oder verwenden Sie query für die Suche.", "tags": [ "contacts" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } }, { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "companyId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "string" }, "kind": { "type": "string", "enum": [ "manual", "membership" ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "archived": { "type": "boolean" }, "sharedWithCounterparty": { "type": "boolean" } }, "required": [ "id", "companyId", "revision", "kind", "name", "position", "email", "phone", "archived", "sharedWithCounterparty" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.contacts", "level": "view" } }, "post": { "operationId": "createContact", "summary": "Ansprechpartner anlegen", "description": "Legt einen manuellen Ansprechpartner für das angegebene Kundenunternehmen an. Verwenden Sie die ID des Kundenprofils als companyId.", "tags": [ "contacts" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "position": { "default": null, "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "email": { "default": null, "anyOf": [ { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "phone": { "default": null, "anyOf": [ { "type": "string", "pattern": "^\\+[1-9]\\d{6,14}$" }, { "type": "null" } ] }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "sharedWithCounterparty": { "default": false, "type": "boolean" } }, "required": [ "name", "companyId" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.contacts", "level": "manage" } } }, "/v1/contacts/{contactId}": { "get": { "operationId": "getContact", "summary": "Ansprechpartner lesen", "description": "Liefert Kontaktdaten, Unternehmenszuordnung und Art eines Ansprechpartners. Freigegebene Ansprechpartner können auch aus der verbundenen Organisation stammen.", "tags": [ "contacts" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "contactId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "string" }, "kind": { "type": "string", "enum": [ "manual", "membership" ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "archived": { "type": "boolean" }, "sharedWithCounterparty": { "type": "boolean" } }, "required": [ "id", "companyId", "revision", "kind", "name", "position", "email", "phone", "archived", "sharedWithCounterparty" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.contacts", "level": "view" } }, "patch": { "operationId": "updateContact", "summary": "Ansprechpartner bearbeiten", "description": "Ändert einen bearbeitbaren manuellen Ansprechpartner mit der angegebenen Revision. Mit einem Benutzerkonto verknüpfte Ansprechpartner werden über dieses Konto gepflegt.", "tags": [ "contacts" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "contactId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "position": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "pattern": "^\\+[1-9]\\d{6,14}$" }, { "type": "null" } ] }, "expectedRevision": { "type": "string", "minLength": 1, "maxLength": 4096 } }, "required": [ "expectedRevision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.contacts", "level": "manage" } } }, "/v1/jobs": { "get": { "operationId": "listJobs", "summary": "Stellen auflisten", "description": "Listet verfügbare Stellen auf. Verwenden Sie query für die Titelsuche oder companyId, um Stellen eines Kundenunternehmens auszuwählen.", "tags": [ "jobs" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } }, { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "companyId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "status": { "type": "string", "enum": [ "open", "closed" ] }, "companyId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "archived": { "type": "boolean" } }, "required": [ "id", "title", "status", "companyId", "archived" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "view" } }, "post": { "operationId": "createJob", "summary": "Stelle anlegen", "description": "Legt eine Stelle für Ihre eigene Arbeitgeberorganisation an. Geben Sie Titel, Anzahl offener Positionen und Inhaltssprachen an. Für Kundenstellen verwenden Sie POST /v1/companies/{companyId}/jobs.", "tags": [ "jobs" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "plannedOpenings": { "type": "string", "pattern": "^[1-9]\\d*$" }, "description": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "outreachSummary": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "applicationUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employmentType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "function": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalQualification": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalSpecialization": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "skills": { "type": "array", "items": { "type": "string" } }, "salaryPeriod": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workLocationType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "contentLocales": { "minItems": 1, "maxItems": 2, "type": "array", "items": { "type": "string", "enum": [ "de", "en" ] } }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "organizationUnitId": { "default": null, "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": [ "title", "plannedOpenings", "contentLocales", "defaultContentLocale" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "manage" } } }, "/v1/jobs/{jobId}": { "get": { "operationId": "getJob", "summary": "Stelle lesen", "description": "Liefert Stellenangaben, Sprachversionen, Kundenbezug und aktuellen Status sowie die Revision für Änderungen.", "tags": [ "jobs" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "plannedOpenings": { "type": "string" }, "description": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "outreachSummary": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "applicationUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employmentType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "function": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalQualification": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalSpecialization": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "skills": { "type": "array", "items": { "type": "string" } }, "salaryPeriod": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workLocationType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "status": { "type": "string", "enum": [ "open", "closed" ] }, "archived": { "type": "boolean" }, "companyId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "string" }, "contentLocales": { "type": "array", "items": { "type": "string", "enum": [ "de", "en" ] } }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] } }, "required": [ "status", "archived", "companyId", "id", "revision", "contentLocales", "defaultContentLocale" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "view" } }, "patch": { "operationId": "updateJob", "summary": "Stelle bearbeiten", "description": "Ändert die angegebenen Stellenfelder mit der zuletzt gelesenen Revision. Nicht übermittelte Felder bleiben unverändert. Zum Schließen einer Stelle verwenden Sie den closure-Endpunkt.", "tags": [ "jobs" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "plannedOpenings": { "type": "string" }, "description": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "outreachSummary": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "applicationUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employmentType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "function": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalQualification": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalSpecialization": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "skills": { "type": "array", "items": { "type": "string" } }, "salaryPeriod": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workLocationType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "expectedRevision": { "type": "string", "minLength": 1, "maxLength": 4096 } }, "required": [ "expectedRevision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "manage" } } }, "/v1/companies/{companyId}/jobs": { "post": { "operationId": "createCompanyJob", "summary": "Stelle für einen Kunden anlegen", "description": "Legt eine Stelle für das angegebene Kundenunternehmen an. companyId bezeichnet das Kundenprofil, für das Ihre Organisation Stellen verwalten darf.", "tags": [ "jobs" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "companyId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "plannedOpenings": { "type": "string", "pattern": "^[1-9]\\d*$" }, "description": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "outreachSummary": { "anyOf": [ { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "applicationUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employmentType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "function": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumExperience": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalQualification": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "educationalSpecialization": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "skills": { "type": "array", "items": { "type": "string" } }, "salaryPeriod": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maximumSalary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workLocationType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "houseNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postalCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customFields": { "type": "object", "propertyNames": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ] } }, "contentLocales": { "minItems": 1, "maxItems": 2, "type": "array", "items": { "type": "string", "enum": [ "de", "en" ] } }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "organizationUnitId": { "default": null, "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": [ "title", "plannedOpenings", "contentLocales", "defaultContentLocale" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "manage" } } }, "/v1/jobs/{jobId}/closure/preview": { "post": { "operationId": "previewJobClosure", "summary": "Stellenschließung prüfen", "description": "Zeigt die Auswirkungen einer Stellenschließung, einschließlich betroffener Bewerbungen und erforderlicher Angaben. Prüfen Sie die Vorschau vor dem Schließen; dieser Aufruf ändert keine Daten.", "tags": [ "jobs" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Aktuelle Folgen und Bestätigung", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "blocked" }, "action": { "type": "string", "enum": [ "archive", "reactivate", "erase", "close", "handoff" ] }, "blockers": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "active_candidacies", "open_jobs", "job_open", "employer_access_missing", "already_erased", "responsibility_changed" ] } }, "effects": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "erase_contents", "end_work", "handoff", "preserve", "hide", "restore" ] }, "resource": { "type": "string", "enum": [ "candidate", "candidacy", "job", "customer", "employer", "invitation" ] }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "resource", "count" ], "additionalProperties": false } } }, "required": [ "kind", "action", "blockers", "effects" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "action_preview" }, "action": { "type": "string", "enum": [ "archive", "reactivate", "erase", "close", "handoff" ] }, "effects": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "erase_contents", "end_work", "handoff", "preserve", "hide", "restore" ] }, "resource": { "type": "string", "enum": [ "candidate", "candidacy", "job", "customer", "employer", "invitation" ] }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "resource", "count" ], "additionalProperties": false } }, "confirmation": { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "warnings": { "readOnly": true, "maxItems": 1500, "type": "array", "items": { "not": {} } } }, "required": [ "previewFingerprint", "warnings" ], "additionalProperties": false } }, "required": [ "kind", "action", "effects", "confirmation" ], "additionalProperties": false } ] } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "manage" } } }, "/v1/jobs/{jobId}/closure": { "post": { "operationId": "commitJobClosure", "summary": "Stelle schließen", "description": "Schließt die Stelle mit der erforderlichen Bestätigung aus der Vorschau. Bei zwischenzeitlichen Änderungen ist eine neue Vorschau erforderlich.", "tags": [ "jobs" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "confirmation": { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "previewFingerprint" ], "additionalProperties": false } }, "required": [ "confirmation" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Bestätigte Ausführung", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "manage" } } }, "/v1/hiring-process/applications": { "get": { "operationId": "listApplications", "summary": "Bewerbungen auflisten", "description": "Listet Bewerbungen auf. Filtern Sie nach Kandidat, Stelle, Status oder Prozessphase. Arbeitgeber sehen die für sie freigegebenen Bewerbungen.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } }, { "name": "candidateId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "jobId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "active", "closed", "hired" ] } }, { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateNumber": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "status": { "type": "string", "enum": [ "active", "closed", "hired" ] }, "disclosure": { "type": "string", "enum": [ "full", "released" ] }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "name", "revision" ], "additionalProperties": false }, "interestConfirmed": { "type": "boolean" }, "presentedToEmployerAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "candidateId", "candidateNumber", "jobId", "status", "disclosure", "stage", "interestConfirmed", "presentedToEmployerAt", "createdAt" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } }, "post": { "operationId": "createApplication", "summary": "Bewerbung anlegen", "description": "Ordnet einen bestehenden Kandidaten einer Stelle zu und startet die gewählte Prozessphase. Prüfen Sie die Anlage zuvor über den preview-Endpunkt und übergeben Sie eine angeforderte Bestätigung.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contactRecording": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "email", "document", "verbal_record", "form", "in_person", "other", "staff_override" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "statement": { "type": "string", "maxLength": 100000 }, "sourceReference": { "type": "string", "maxLength": 500 }, "note": { "type": "string", "maxLength": 5000 }, "writtenEvidence": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "sender": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "recipient": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "fullText": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100000 }, { "type": "null" } ] } }, "required": [ "kind", "sender", "recipient", "sentAt", "fullText" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf" }, "privacyDocumentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "privacyDocumentId" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf_upload" }, "uploadIntentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "uploadIntentId" ], "additionalProperties": false } ] } }, "required": [ "source", "occurredAt", "writtenEvidence" ], "additionalProperties": false }, "declarations": { "type": "object", "properties": { "interest": { "type": "object", "properties": { "decision": { "type": "string", "const": "granted" }, "declaration": { "type": "object", "properties": { "recordingMode": { "type": "string", "const": "declaration" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "locale": { "type": "string", "enum": [ "de", "en" ] }, "noticeText": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "null" } ] }, "writtenEvidence": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "sender": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "recipient": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "fullText": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100000 }, { "type": "null" } ] } }, "required": [ "kind", "sender", "recipient", "sentAt", "fullText" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf" }, "privacyDocumentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "privacyDocumentId" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf_upload" }, "uploadIntentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "uploadIntentId" ], "additionalProperties": false } ] } }, "required": [ "occurredAt", "locale", "noticeText", "writtenEvidence" ], "additionalProperties": false } }, "required": [ "decision", "declaration" ], "additionalProperties": false }, "employerSharing": { "type": "object", "properties": { "recordingMode": { "type": "string", "const": "declaration" }, "locale": { "type": "string", "enum": [ "de", "en" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "writtenEvidence": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "sender": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "recipient": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "fullText": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100000 }, { "type": "null" } ] } }, "required": [ "kind", "sender", "recipient", "sentAt", "fullText" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf" }, "privacyDocumentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "privacyDocumentId" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf_upload" }, "uploadIntentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "uploadIntentId" ], "additionalProperties": false } ] }, "decision": { "type": "string", "const": "granted" } }, "required": [ "locale", "occurredAt", "writtenEvidence", "decision" ], "additionalProperties": false } }, "additionalProperties": false }, "preparation": { "type": "object", "properties": { "confirmInterest": { "type": "boolean" }, "presentToEmployer": { "type": "boolean" } }, "required": [ "confirmInterest", "presentToEmployer" ], "additionalProperties": false }, "contactDecisions": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "email", "whatsapp", "sms", "voice_call" ] }, "purposes": { "minItems": 1, "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedContactPointRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "evidence": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "consent" }, "source": { "type": "string", "enum": [ "email", "document", "verbal_record", "form", "in_person", "other" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "statement": { "type": "string", "maxLength": 4000 }, "sourceReference": { "type": "string", "maxLength": 500 }, "note": { "type": "string", "maxLength": 2000 } }, "required": [ "kind", "source", "occurredAt" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "staff_override" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "note": { "type": "string", "maxLength": 2000 } }, "required": [ "kind", "occurredAt" ], "additionalProperties": false } ] } }, "required": [ "method", "purposes", "contactPointId", "expectedContactPointRevision", "evidence" ], "additionalProperties": false } }, "confirmation": { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "previewFingerprint" ], "additionalProperties": false }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "entryStage": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "inputs": { "maxItems": 1, "type": "array", "items": { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "value": { "type": "object", "properties": { "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "ruleSource": { "type": "string", "enum": [ "job", "user" ] }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "ownerMembershipId", "ruleSource", "expectedSettingsRevision", "expectedScheduleRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false } } }, "required": [ "preparation", "jobId", "candidateId" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "manage" } } }, "/v1/hiring-process/applications/preview": { "post": { "operationId": "previewApplication", "summary": "Zuordnung prüfen", "description": "Prüft die geplante Kandidat-Stellen-Zuordnung und liefert Fehler, Warnungen und erforderliche Bestätigungen. Die Vorschau legt noch keine Bewerbung an.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contactRecording": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "email", "document", "verbal_record", "form", "in_person", "other", "staff_override" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "statement": { "type": "string", "maxLength": 100000 }, "sourceReference": { "type": "string", "maxLength": 500 }, "note": { "type": "string", "maxLength": 5000 }, "writtenEvidence": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "sender": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "recipient": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "fullText": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100000 }, { "type": "null" } ] } }, "required": [ "kind", "sender", "recipient", "sentAt", "fullText" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf" }, "privacyDocumentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "privacyDocumentId" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf_upload" }, "uploadIntentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "uploadIntentId" ], "additionalProperties": false } ] } }, "required": [ "source", "occurredAt", "writtenEvidence" ], "additionalProperties": false }, "declarations": { "type": "object", "properties": { "interest": { "type": "object", "properties": { "decision": { "type": "string", "const": "granted" }, "declaration": { "type": "object", "properties": { "recordingMode": { "type": "string", "const": "declaration" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "locale": { "type": "string", "enum": [ "de", "en" ] }, "noticeText": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "null" } ] }, "writtenEvidence": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "sender": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "recipient": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "fullText": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100000 }, { "type": "null" } ] } }, "required": [ "kind", "sender", "recipient", "sentAt", "fullText" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf" }, "privacyDocumentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "privacyDocumentId" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf_upload" }, "uploadIntentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "uploadIntentId" ], "additionalProperties": false } ] } }, "required": [ "occurredAt", "locale", "noticeText", "writtenEvidence" ], "additionalProperties": false } }, "required": [ "decision", "declaration" ], "additionalProperties": false }, "employerSharing": { "type": "object", "properties": { "recordingMode": { "type": "string", "const": "declaration" }, "locale": { "type": "string", "enum": [ "de", "en" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "writtenEvidence": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "sender": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "recipient": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "fullText": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100000 }, { "type": "null" } ] } }, "required": [ "kind", "sender", "recipient", "sentAt", "fullText" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf" }, "privacyDocumentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "privacyDocumentId" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "pdf_upload" }, "uploadIntentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "uploadIntentId" ], "additionalProperties": false } ] }, "decision": { "type": "string", "const": "granted" } }, "required": [ "locale", "occurredAt", "writtenEvidence", "decision" ], "additionalProperties": false } }, "additionalProperties": false }, "preparation": { "type": "object", "properties": { "confirmInterest": { "type": "boolean" }, "presentToEmployer": { "type": "boolean" } }, "required": [ "confirmInterest", "presentToEmployer" ], "additionalProperties": false }, "contactDecisions": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "email", "whatsapp", "sms", "voice_call" ] }, "purposes": { "minItems": 1, "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedContactPointRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "evidence": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "consent" }, "source": { "type": "string", "enum": [ "email", "document", "verbal_record", "form", "in_person", "other" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "statement": { "type": "string", "maxLength": 4000 }, "sourceReference": { "type": "string", "maxLength": 500 }, "note": { "type": "string", "maxLength": 2000 } }, "required": [ "kind", "source", "occurredAt" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "staff_override" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "note": { "type": "string", "maxLength": 2000 } }, "required": [ "kind", "occurredAt" ], "additionalProperties": false } ] } }, "required": [ "method", "purposes", "contactPointId", "expectedContactPointRevision", "evidence" ], "additionalProperties": false } }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "entryStage": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "inputs": { "maxItems": 1, "type": "array", "items": { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "value": { "type": "object", "properties": { "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "ruleSource": { "type": "string", "enum": [ "job", "user" ] }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "ownerMembershipId", "ruleSource", "expectedSettingsRevision", "expectedScheduleRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false } } }, "required": [ "preparation", "jobId", "candidateId" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "targetStage": { "anyOf": [ { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, { "type": "null" } ] }, "declarations": { "anyOf": [ { "type": "object", "properties": { "interest": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "not_required" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "missing" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "drafted" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "occurredAt" ], "additionalProperties": false } ] }, "employerSharing": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "not_required" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "missing" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "drafted" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "occurredAt" ], "additionalProperties": false } ] }, "canRecord": { "type": "boolean" } }, "required": [ "interest", "employerSharing", "canRecord" ], "additionalProperties": false }, { "type": "null" } ] }, "errors": { "type": "array", "items": { "type": "string", "enum": [ "stage_unavailable", "interest_required", "interest_stage_preparation_conflict", "presentation_required", "appointment_setup_required", "contact_missing", "contact_changed", "contact_recording_invalid", "not_found", "forbidden", "conflict" ] } }, "confirmation": { "anyOf": [ { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "warnings": { "readOnly": true, "maxItems": 1500, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "admission_interest_declaration", "admission_employer_sharing_declaration" ] }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidate": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "existing" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "candidateId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "new" }, "draftFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "draftFingerprint" ], "additionalProperties": false } ] }, "reason": { "type": "string", "const": "missing" }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "jobId", "candidate", "reason", "factsFingerprint" ], "additionalProperties": false } } }, "required": [ "previewFingerprint", "warnings" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "candidateId", "jobId", "targetStage", "declarations", "errors", "confirmation" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "manage" } } }, "/v1/hiring-process/applications/{applicationId}": { "get": { "operationId": "getApplication", "summary": "Bewerbung lesen", "description": "Liefert Status, aktuelle Prozessphase und Freigabestatus einer Bewerbung. Die Stage-Revision wird für nachfolgende Prozessaktionen benötigt.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateNumber": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "status": { "type": "string", "enum": [ "active", "closed", "hired" ] }, "disclosure": { "type": "string", "enum": [ "full", "released" ] }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "name", "revision" ], "additionalProperties": false }, "interestConfirmed": { "type": "boolean" }, "presentedToEmployerAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "candidateId", "candidateNumber", "jobId", "status", "disclosure", "stage", "interestConfirmed", "presentedToEmployerAt", "createdAt" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } } }, "/v1/hiring-process/applications/{applicationId}/actions": { "get": { "operationId": "getApplicationActions", "summary": "Verfügbare Handlungen", "description": "Liefert die aktuell angebotenen Prozessaktionen und die zugehörige Stage-Revision. Rufen Sie die Vorschau einer Aktion auf, um deren Voraussetzungen und Auswirkungen zu prüfen.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "expectedStageRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "actions": { "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "start_resume_collection", "start_qualification", "start_recruiter_review", "start_employer_sharing_approval", "start_employer_review", "start_interview_coordination", "start_interview", "start_final_decision", "complete_interest_confirmation", "complete_resume_collection", "complete_qualification", "complete_recruiter_review", "complete_employer_sharing_approval", "complete_employer_review", "complete_interview_coordination", "resolve_interview_clarification", "complete_final_decision", "close_candidacy_as_rejected", "close_candidacy_as_withdrawn", "hire_candidacy" ] }, "previewUrl": { "type": "string" } }, "required": [ "action", "previewUrl" ], "additionalProperties": false } } }, "required": [ "expectedStageRevision", "actions" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } }, "post": { "operationId": "executeApplicationAction", "summary": "Handlung ausführen", "description": "Führt die gewählte Prozessaktion mit den geprüften Eingaben und der erwarteten Stage-Revision aus. Übergeben Sie eine von der Vorschau angeforderte Bestätigung. Bei einem Konflikt laden Sie den aktuellen Stand und prüfen die Aktion erneut.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "start_resume_collection", "start_qualification", "start_recruiter_review", "start_employer_sharing_approval", "start_employer_review", "start_interview_coordination", "start_interview", "start_final_decision", "complete_interest_confirmation", "complete_resume_collection", "complete_qualification", "complete_recruiter_review", "complete_employer_sharing_approval", "complete_employer_review", "complete_interview_coordination", "resolve_interview_clarification", "complete_final_decision", "close_candidacy_as_rejected", "close_candidacy_as_withdrawn", "hire_candidacy" ] }, "expectedStageRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "inputs": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.confirm_interest" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "minLength": 1 }, "declarationException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "minLength": 1 } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "contextFingerprint", "declarationException" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.present_to_employer" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "minLength": 1 }, "declarationException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "minLength": 1 } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "contextFingerprint", "declarationException" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "channels": { "maxItems": 3, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "disabled" } }, "required": [ "channel", "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "use_permission" } }, "required": [ "channel", "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "permission_exception" }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "channel", "decision", "factsFingerprint" ], "additionalProperties": false } ] } } }, "required": [ "contextFingerprint", "channels" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "value": { "type": "object", "properties": { "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "ruleSource": { "type": "string", "enum": [ "job", "user" ] }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "ownerMembershipId", "ruleSource", "expectedSettingsRevision", "expectedScheduleRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "value": { "type": "object", "properties": { "draft": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "startsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" }, "description": { "anyOf": [ { "type": "string", "maxLength": 10000 }, { "type": "null" } ] }, "locationText": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "meetingUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "meetingProvider": { "default": null, "anyOf": [ { "type": "string", "enum": [ "google", "microsoft" ] }, { "type": "null" } ] }, "meetingComparisonKey": { "default": null, "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 128 }, { "type": "null" } ] }, "participants": { "maxItems": 100, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "membership" }, "membershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "membershipId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "candidateId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "external" }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "email": { "anyOf": [ { "type": "string", "maxLength": 320, "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "contact": { "type": "object", "properties": { "engagementContactId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "endpointFingerprint": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "engagementContactId", "endpointFingerprint" ], "additionalProperties": false } }, "required": [ "kind", "name", "email" ], "additionalProperties": false } ] } }, "associations": { "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "recruiting_engagement" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } } }, "required": [ "title", "defaultContentLocale", "ownerMembershipId", "startsAt", "endsAt", "timeZone", "description", "locationText", "meetingUrl", "participants", "associations" ], "additionalProperties": false }, "operationId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedReviewKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "acknowledgedReasons": { "maxItems": 3, "type": "array", "items": { "type": "string", "enum": [ "calendar_conflict", "appointment_conflict", "calendar_unverified" ] } } }, "required": [ "draft", "operationId", "expectedReviewKey", "acknowledgedReasons" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "value": { "oneOf": [ { "type": "object", "properties": { "send": { "type": "boolean", "const": false } }, "required": [ "send" ], "additionalProperties": false }, { "type": "object", "properties": { "send": { "type": "boolean", "const": true }, "expectedContactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedContactPointRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "email": { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "subject": { "type": "string", "minLength": 1, "maxLength": 998 }, "locale": { "type": "string", "enum": [ "de", "en" ] }, "body": { "type": "object", "properties": { "format": { "type": "string", "const": "html-v1" }, "html": { "type": "string", "maxLength": 200000 } }, "required": [ "format", "html" ], "additionalProperties": false }, "signature": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "none" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "profile" }, "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "mode", "expectedRevision" ], "additionalProperties": false } ] } }, "required": [ "kind", "subject", "locale", "body", "signature" ], "additionalProperties": false }, "permissionException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "send", "expectedContactPointId", "expectedContactPointRevision", "email", "permissionException" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_slot_booking" }, "value": { "type": "object", "properties": { "appointmentJobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedAppointmentJobRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "startsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "displayTimeZone": { "type": "string", "minLength": 1, "maxLength": 64 }, "override": { "anyOf": [ { "type": "object", "properties": { "acknowledgedReasons": { "minItems": 1, "maxItems": 5, "type": "array", "items": { "type": "string", "enum": [ "calendar_conflict", "appointment_conflict", "outside_schedule", "outside_regular_grid", "calendar_unverified" ] } }, "expectedReviewKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "acknowledgedReasons", "expectedReviewKey" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "appointmentJobId", "expectedAppointmentJobRevision", "expectedScheduleRevision", "startsAt", "displayTimeZone", "override" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_sharing_decision" }, "value": { "type": "object", "properties": { "decisionId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "expectedPrivacyRevision": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "decisionId", "expectedPrivacyRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "none" }, "value": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interest_decision" }, "value": { "type": "object", "properties": { "decision": { "type": "string", "enum": [ "granted", "declined" ] }, "declaration": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "existing" }, "decisionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedInterestRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "decisionId", "expectedInterestRevision" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "decision", "declaration" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.resume_collection_resolution" }, "value": { "oneOf": [ { "type": "object", "properties": { "selection": { "type": "string", "const": "existing" }, "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "selection", "documentId", "expectedResumeRevision" ], "additionalProperties": false }, { "type": "object", "properties": { "selection": { "type": "string", "const": "without_resume" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "selection", "expectedResumeRevision" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.qualification_completion" }, "value": { "type": "object", "properties": { "expectedAnswerRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gapHandling": { "type": "string", "enum": [ "require_complete", "accept_with_gaps" ] } }, "required": [ "expectedAnswerRevision", "gapHandling" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_review_decision" }, "value": { "oneOf": [ { "type": "object", "properties": { "decision": { "type": "string", "const": "approved" } }, "required": [ "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "decision": { "type": "string", "const": "rejected" }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "decision", "reason" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_clarification_resolution" }, "value": { "type": "object", "properties": { "resolution": { "type": "string", "enum": [ "continue", "reschedule", "reject", "withdraw" ] }, "expectedAppointmentRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedCalendarIssueRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "resolution", "expectedAppointmentRevision", "expectedCalendarIssueRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.final_decision" }, "value": { "oneOf": [ { "type": "object", "properties": { "decision": { "type": "string", "const": "hire" } }, "required": [ "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "decision": { "type": "string", "const": "reject" }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "decision", "reason" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false } ] } }, "confirmation": { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "previewFingerprint" ], "additionalProperties": false } }, "required": [ "action", "expectedStageRevision", "inputs" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "manage" } } }, "/v1/hiring-process/applications/{applicationId}/actions/preview": { "post": { "operationId": "previewApplicationAction", "summary": "Handlung prüfen", "description": "Prüft die gewählte Aktion mit ihren Eingaben und der erwarteten Stage-Revision. Liefert Voraussetzungen, Hinweise und gegebenenfalls eine erforderliche Bestätigung, ohne die Aktion auszuführen.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "start_resume_collection", "start_qualification", "start_recruiter_review", "start_employer_sharing_approval", "start_employer_review", "start_interview_coordination", "start_interview", "start_final_decision", "complete_interest_confirmation", "complete_resume_collection", "complete_qualification", "complete_recruiter_review", "complete_employer_sharing_approval", "complete_employer_review", "complete_interview_coordination", "resolve_interview_clarification", "complete_final_decision", "close_candidacy_as_rejected", "close_candidacy_as_withdrawn", "hire_candidacy" ] }, "expectedStageRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "inputs": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.confirm_interest" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "minLength": 1 }, "declarationException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "minLength": 1 } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "contextFingerprint", "declarationException" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.present_to_employer" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "minLength": 1 }, "declarationException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "minLength": 1 } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "contextFingerprint", "declarationException" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "channels": { "maxItems": 3, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "disabled" } }, "required": [ "channel", "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "use_permission" } }, "required": [ "channel", "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "permission_exception" }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "channel", "decision", "factsFingerprint" ], "additionalProperties": false } ] } } }, "required": [ "contextFingerprint", "channels" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "value": { "type": "object", "properties": { "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "ruleSource": { "type": "string", "enum": [ "job", "user" ] }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "ownerMembershipId", "ruleSource", "expectedSettingsRevision", "expectedScheduleRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "value": { "type": "object", "properties": { "draft": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "startsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" }, "description": { "anyOf": [ { "type": "string", "maxLength": 10000 }, { "type": "null" } ] }, "locationText": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "meetingUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "meetingProvider": { "default": null, "anyOf": [ { "type": "string", "enum": [ "google", "microsoft" ] }, { "type": "null" } ] }, "meetingComparisonKey": { "default": null, "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 128 }, { "type": "null" } ] }, "participants": { "maxItems": 100, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "membership" }, "membershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "membershipId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "candidateId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "external" }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "email": { "anyOf": [ { "type": "string", "maxLength": 320, "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "contact": { "type": "object", "properties": { "engagementContactId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "endpointFingerprint": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "engagementContactId", "endpointFingerprint" ], "additionalProperties": false } }, "required": [ "kind", "name", "email" ], "additionalProperties": false } ] } }, "associations": { "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "recruiting_engagement" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } } }, "required": [ "title", "defaultContentLocale", "ownerMembershipId", "startsAt", "endsAt", "timeZone", "description", "locationText", "meetingUrl", "participants", "associations" ], "additionalProperties": false }, "operationId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedReviewKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "acknowledgedReasons": { "maxItems": 3, "type": "array", "items": { "type": "string", "enum": [ "calendar_conflict", "appointment_conflict", "calendar_unverified" ] } } }, "required": [ "draft", "operationId", "expectedReviewKey", "acknowledgedReasons" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "value": { "oneOf": [ { "type": "object", "properties": { "send": { "type": "boolean", "const": false } }, "required": [ "send" ], "additionalProperties": false }, { "type": "object", "properties": { "send": { "type": "boolean", "const": true }, "expectedContactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedContactPointRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "email": { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "subject": { "type": "string", "minLength": 1, "maxLength": 998 }, "locale": { "type": "string", "enum": [ "de", "en" ] }, "body": { "type": "object", "properties": { "format": { "type": "string", "const": "html-v1" }, "html": { "type": "string", "maxLength": 200000 } }, "required": [ "format", "html" ], "additionalProperties": false }, "signature": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "none" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "profile" }, "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "mode", "expectedRevision" ], "additionalProperties": false } ] } }, "required": [ "kind", "subject", "locale", "body", "signature" ], "additionalProperties": false }, "permissionException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "send", "expectedContactPointId", "expectedContactPointRevision", "email", "permissionException" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_slot_booking" }, "value": { "type": "object", "properties": { "appointmentJobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedAppointmentJobRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "startsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "displayTimeZone": { "type": "string", "minLength": 1, "maxLength": 64 }, "override": { "anyOf": [ { "type": "object", "properties": { "acknowledgedReasons": { "minItems": 1, "maxItems": 5, "type": "array", "items": { "type": "string", "enum": [ "calendar_conflict", "appointment_conflict", "outside_schedule", "outside_regular_grid", "calendar_unverified" ] } }, "expectedReviewKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "acknowledgedReasons", "expectedReviewKey" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "appointmentJobId", "expectedAppointmentJobRevision", "expectedScheduleRevision", "startsAt", "displayTimeZone", "override" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_sharing_decision" }, "value": { "type": "object", "properties": { "decisionId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "expectedPrivacyRevision": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "decisionId", "expectedPrivacyRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "none" }, "value": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interest_decision" }, "value": { "type": "object", "properties": { "decision": { "type": "string", "enum": [ "granted", "declined" ] }, "declaration": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "existing" }, "decisionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedInterestRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "decisionId", "expectedInterestRevision" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "decision", "declaration" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.resume_collection_resolution" }, "value": { "oneOf": [ { "type": "object", "properties": { "selection": { "type": "string", "const": "existing" }, "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "selection", "documentId", "expectedResumeRevision" ], "additionalProperties": false }, { "type": "object", "properties": { "selection": { "type": "string", "const": "without_resume" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "selection", "expectedResumeRevision" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.qualification_completion" }, "value": { "type": "object", "properties": { "expectedAnswerRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gapHandling": { "type": "string", "enum": [ "require_complete", "accept_with_gaps" ] } }, "required": [ "expectedAnswerRevision", "gapHandling" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_review_decision" }, "value": { "oneOf": [ { "type": "object", "properties": { "decision": { "type": "string", "const": "approved" } }, "required": [ "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "decision": { "type": "string", "const": "rejected" }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "decision", "reason" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_clarification_resolution" }, "value": { "type": "object", "properties": { "resolution": { "type": "string", "enum": [ "continue", "reschedule", "reject", "withdraw" ] }, "expectedAppointmentRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedCalendarIssueRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "resolution", "expectedAppointmentRevision", "expectedCalendarIssueRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.final_decision" }, "value": { "oneOf": [ { "type": "object", "properties": { "decision": { "type": "string", "const": "hire" } }, "required": [ "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "decision": { "type": "string", "const": "reject" }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "decision", "reason" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false } ] } } }, "required": [ "action", "expectedStageRevision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "blocked" }, "reason": { "type": "string", "enum": [ "processing_basis_missing", "employer_sharing_consent_missing", "employer_sharing_consent_withdrawn", "employer_sharing_consent_declined", "employer_sharing_scope_mismatch", "stage_work_resume_required" ] }, "remedies": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "record_application_interest" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "candidacyId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "record_employer_sharing_consent" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "candidacyId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "resume_contact_plan" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "planId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "stageRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "candidacyId", "planId", "stageRevision" ], "additionalProperties": false } ] } } }, "required": [ "kind", "reason", "remedies" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "requirements_missing" }, "commandKey": { "type": "string", "enum": [ "complete_interest_confirmation", "complete_resume_collection", "complete_qualification", "complete_recruiter_review", "complete_employer_sharing_approval", "complete_employer_review", "complete_interview_coordination", "resolve_interview_clarification", "complete_final_decision", "start_resume_collection", "start_qualification", "start_recruiter_review", "start_employer_sharing_approval", "start_employer_review", "start_interview_coordination", "start_interview", "start_final_decision", "close_candidacy_as_rejected", "close_candidacy_as_withdrawn", "hire_candidacy" ] }, "decision": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false }, "preparation": { "type": "object", "properties": { "items": { "type": "array", "items": { "anyOf": [ { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.confirm_interest" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.confirm_interest" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.present_to_employer" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.present_to_employer" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_stage" }, "contextFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "candidateName": { "type": "string" }, "jobName": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "stageName": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "employer_sharing_approval", "interview_coordination" ] }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, "routineKey": { "type": "string" }, "channels": { "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "enabled": { "type": "boolean" }, "contactPointId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "contactPointRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "contactValue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "permission": { "type": "string", "enum": [ "allowed", "permission_missing", "permission_withdrawn", "permission_blocked" ] }, "permissionBasis": { "anyOf": [ { "type": "string", "enum": [ "permission", "staff_override" ] }, { "type": "null" } ] }, "permissionScopePurpose": { "anyOf": [ { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, { "type": "null" } ] }, "fallbackChannel": { "type": "boolean" }, "warning": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "contact_missing", "contact_changed", "application_inactive", "endpoint_suppressed", "provider_disabled" ] }, { "type": "null" } ] }, "messageKeys": { "type": "array", "items": { "type": "string" } } }, "required": [ "channel", "enabled", "contactPointId", "contactPointRevision", "permission", "permissionBasis", "warning", "unavailableReason", "messageKeys" ], "additionalProperties": false } }, "steps": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "message" }, "messageKey": { "type": "string", "enum": [ "mobile", "email", "email_reminder" ] }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] }, "channels": { "minItems": 1, "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "fallback": { "type": "boolean" } }, "required": [ "channel", "fallback" ], "additionalProperties": false } } }, "required": [ "kind", "messageKey", "schedule", "channels" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "human_attention" }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] } }, "required": [ "kind", "schedule" ], "additionalProperties": false } ] } } }, "required": [ "kind", "contextFingerprint", "candidacyId", "candidateId", "stageName", "purpose", "routineKey", "channels", "steps" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_stage" }, "contextFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "candidateName": { "type": "string" }, "jobName": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "stageName": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "employer_sharing_approval", "interview_coordination" ] }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, "routineKey": { "type": "string" }, "channels": { "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "enabled": { "type": "boolean" }, "contactPointId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "contactPointRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "contactValue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "permission": { "type": "string", "enum": [ "allowed", "permission_missing", "permission_withdrawn", "permission_blocked" ] }, "permissionBasis": { "anyOf": [ { "type": "string", "enum": [ "permission", "staff_override" ] }, { "type": "null" } ] }, "permissionScopePurpose": { "anyOf": [ { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, { "type": "null" } ] }, "fallbackChannel": { "type": "boolean" }, "warning": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "contact_missing", "contact_changed", "application_inactive", "endpoint_suppressed", "provider_disabled" ] }, { "type": "null" } ] }, "messageKeys": { "type": "array", "items": { "type": "string" } } }, "required": [ "channel", "enabled", "contactPointId", "contactPointRevision", "permission", "permissionBasis", "warning", "unavailableReason", "messageKeys" ], "additionalProperties": false } }, "steps": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "message" }, "messageKey": { "type": "string", "enum": [ "mobile", "email", "email_reminder" ] }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] }, "channels": { "minItems": 1, "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "fallback": { "type": "boolean" } }, "required": [ "channel", "fallback" ], "additionalProperties": false } } }, "required": [ "kind", "messageKey", "schedule", "channels" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "human_attention" }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] } }, "required": [ "kind", "schedule" ], "additionalProperties": false } ] } } }, "required": [ "kind", "contextFingerprint", "candidacyId", "candidateId", "stageName", "purpose", "routineKey", "channels", "steps" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "candidacyId", "jobId" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "candidacyId", "jobId" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "withdrawal", "rejection", "hiring" ] }, "recipient": { "anyOf": [ { "type": "object", "properties": { "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "address": { "type": "string" } }, "required": [ "contactPointId", "revision", "address" ], "additionalProperties": false }, { "type": "null" } ] }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false } }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "no_email_contact", "endpoint_suppressed", "delivery_unavailable" ] }, { "type": "null" } ] }, "draft": { "type": "object", "properties": { "subject": { "type": "string", "maxLength": 998 }, "html": { "type": "string", "maxLength": 200000 }, "locale": { "type": "string", "enum": [ "de", "en" ] } }, "required": [ "subject", "html", "locale" ], "additionalProperties": false }, "sender": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "member_mailbox" }, "address": { "type": "string" } }, "required": [ "kind", "address" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "platform" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "signature": { "anyOf": [ { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedRevision" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "kind", "recipient", "warnings", "unavailableReason", "draft", "sender", "signature" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "withdrawal", "rejection", "hiring" ] }, "recipient": { "anyOf": [ { "type": "object", "properties": { "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "address": { "type": "string" } }, "required": [ "contactPointId", "revision", "address" ], "additionalProperties": false }, { "type": "null" } ] }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false } }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "no_email_contact", "endpoint_suppressed", "delivery_unavailable" ] }, { "type": "null" } ] }, "draft": { "type": "object", "properties": { "subject": { "type": "string", "maxLength": 998 }, "html": { "type": "string", "maxLength": 200000 }, "locale": { "type": "string", "enum": [ "de", "en" ] } }, "required": [ "subject", "html", "locale" ], "additionalProperties": false }, "sender": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "member_mailbox" }, "address": { "type": "string" } }, "required": [ "kind", "address" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "platform" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "signature": { "anyOf": [ { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedRevision" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "kind", "recipient", "warnings", "unavailableReason", "draft", "sender", "signature" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "context": { "type": "object", "properties": { "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "jobSchedule": { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "rules": { "type": "object", "properties": { "timeZone": { "type": "string" }, "weeklyHours": { "minItems": 7, "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "day": { "type": "integer", "minimum": 1, "maximum": 7 }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "day", "windows" ], "additionalProperties": false } }, "dateSpecificHours": { "maxItems": 730, "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "date", "windows" ], "additionalProperties": false } } }, "required": [ "timeZone", "weeklyHours", "dateSpecificHours" ], "additionalProperties": false } }, "required": [ "revision", "rules" ], "additionalProperties": false }, "durationMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "bookingHorizonDays": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "jobId", "expectedSettingsRevision", "jobSchedule", "durationMinutes", "bookingHorizonDays" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "context": { "type": "object", "properties": { "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "jobSchedule": { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "rules": { "type": "object", "properties": { "timeZone": { "type": "string" }, "weeklyHours": { "minItems": 7, "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "day": { "type": "integer", "minimum": 1, "maximum": 7 }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "day", "windows" ], "additionalProperties": false } }, "dateSpecificHours": { "maxItems": 730, "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "date", "windows" ], "additionalProperties": false } } }, "required": [ "timeZone", "weeklyHours", "dateSpecificHours" ], "additionalProperties": false } }, "required": [ "revision", "rules" ], "additionalProperties": false }, "durationMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "bookingHorizonDays": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "jobId", "expectedSettingsRevision", "jobSchedule", "durationMinutes", "bookingHorizonDays" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_slot_booking" }, "context": { "type": "object", "properties": { "appointmentJobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "appointmentJobRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "durationMinutes": { "type": "integer", "minimum": 5, "maximum": 480 }, "bookingWindow": { "type": "object", "properties": { "opensAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" } }, "required": [ "opensAt", "closesAt", "timeZone" ], "additionalProperties": false }, "scheduleTimeZone": { "type": "string" }, "ownerName": { "type": "string" }, "ownerPhoto": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "version" ], "additionalProperties": false }, { "type": "null" } ] }, "organizationName": { "type": "string" }, "organizationLogoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organizationSymbolUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "canOverride": { "type": "boolean" }, "status": { "type": "string", "enum": [ "open", "booked", "expired", "unavailable" ] } }, "required": [ "appointmentJobId", "appointmentJobRevision", "title", "defaultContentLocale", "durationMinutes", "bookingWindow", "scheduleTimeZone", "ownerName", "ownerPhoto", "organizationName", "organizationLogoUrl", "organizationSymbolUrl", "canOverride", "status" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_slot_booking" }, "context": { "type": "object", "properties": { "appointmentJobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "appointmentJobRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "durationMinutes": { "type": "integer", "minimum": 5, "maximum": 480 }, "bookingWindow": { "type": "object", "properties": { "opensAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" } }, "required": [ "opensAt", "closesAt", "timeZone" ], "additionalProperties": false }, "scheduleTimeZone": { "type": "string" }, "ownerName": { "type": "string" }, "ownerPhoto": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "version" ], "additionalProperties": false }, { "type": "null" } ] }, "organizationName": { "type": "string" }, "organizationLogoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organizationSymbolUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "canOverride": { "type": "boolean" }, "status": { "type": "string", "enum": [ "open", "booked", "expired", "unavailable" ] } }, "required": [ "appointmentJobId", "appointmentJobRevision", "title", "defaultContentLocale", "durationMinutes", "bookingWindow", "scheduleTimeZone", "ownerName", "ownerPhoto", "organizationName", "organizationLogoUrl", "organizationSymbolUrl", "canOverride", "status" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.resume_collection_resolution" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "resume": { "anyOf": [ { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "origin": { "type": "string", "enum": [ "profile_adoption", "candidate_upload", "inbound_message", "candidate_selection", "staff_upload", "staff_profile_adoption" ] }, "assignedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "document": { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false } }, "required": [ "revision", "origin", "assignedAt", "document" ], "additionalProperties": false }, { "type": "null" } ] }, "profileResume": { "anyOf": [ { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false }, { "type": "null" } ] }, "canEdit": { "type": "boolean" }, "canSetProfile": { "type": "boolean" } }, "required": [ "candidacyId", "expectedResumeRevision", "resume", "profileResume", "canEdit", "canSetProfile" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.resume_collection_resolution" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "resume": { "anyOf": [ { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "origin": { "type": "string", "enum": [ "profile_adoption", "candidate_upload", "inbound_message", "candidate_selection", "staff_upload", "staff_profile_adoption" ] }, "assignedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "document": { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false } }, "required": [ "revision", "origin", "assignedAt", "document" ], "additionalProperties": false }, { "type": "null" } ] }, "profileResume": { "anyOf": [ { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false }, { "type": "null" } ] }, "canEdit": { "type": "boolean" }, "canSetProfile": { "type": "boolean" } }, "required": [ "candidacyId", "expectedResumeRevision", "resume", "profileResume", "canEdit", "canSetProfile" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.qualification_completion" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "questionnaireRevisionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedAnswerRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "questionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "answeredQuestionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missingRequiredQuestionIds": { "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "completionRuleViolation": { "anyOf": [ { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "unknown_question", "duplicate_question", "kind_mismatch", "empty_text", "text_too_long", "invalid_value" ] }, "questionKey": { "type": "string" } }, "required": [ "reason", "questionKey" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "questionnaireRevisionId", "expectedAnswerRevision", "questionCount", "answeredQuestionCount", "missingRequiredQuestionIds", "completionRuleViolation" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.qualification_completion" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "questionnaireRevisionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedAnswerRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "questionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "answeredQuestionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missingRequiredQuestionIds": { "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "completionRuleViolation": { "anyOf": [ { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "unknown_question", "duplicate_question", "kind_mismatch", "empty_text", "text_too_long", "invalid_value" ] }, "questionKey": { "type": "string" } }, "required": [ "reason", "questionKey" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "questionnaireRevisionId", "expectedAnswerRevision", "questionCount", "answeredQuestionCount", "missingRequiredQuestionIds", "completionRuleViolation" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_review_decision" }, "context": { "type": "object", "properties": { "decision": { "anyOf": [ { "type": "string", "const": "approved" }, { "type": "null" } ] } }, "required": [ "decision" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_review_decision" }, "context": { "type": "object", "properties": { "decision": { "anyOf": [ { "type": "string", "const": "approved" }, { "type": "null" } ] } }, "required": [ "decision" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_clarification_resolution" }, "context": { "type": "object", "properties": { "expectedAppointmentRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedCalendarIssueRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reason": { "type": "string", "enum": [ "calendar_entry_deleted", "calendar_entry_missing", "calendar_interval_invalid", "calendar_change_not_applicable", "appointment_cancelled" ] } }, "required": [ "expectedAppointmentRevision", "expectedCalendarIssueRevision", "endsAt", "reason" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_clarification_resolution" }, "context": { "type": "object", "properties": { "expectedAppointmentRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedCalendarIssueRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reason": { "type": "string", "enum": [ "calendar_entry_deleted", "calendar_entry_missing", "calendar_interval_invalid", "calendar_change_not_applicable", "appointment_cancelled" ] } }, "required": [ "expectedAppointmentRevision", "expectedCalendarIssueRevision", "endsAt", "reason" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.final_decision" }, "context": { "type": "object", "properties": {}, "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.final_decision" }, "context": { "type": "object", "properties": {}, "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "inputKey": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] }, "state": { "type": "string", "enum": [ "conditional", "waiting" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "possibleConsequences", "inputKey", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "inputKey": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] }, "state": { "type": "string", "const": "not_applicable" }, "reason": { "type": "string", "enum": [ "outcome_not_applicable", "alternative_not_selected" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "possibleConsequences", "inputKey", "state", "reason" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "optional_record_action" }, "action": { "type": "string", "enum": [ "review_application_contact" ] }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "state": { "type": "string", "enum": [ "conditional", "waiting", "available" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "action", "candidacyId", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "optional_record_action" }, "action": { "type": "string", "enum": [ "review_application_contact" ] }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "state": { "type": "string", "const": "not_applicable" }, "reason": { "type": "string", "enum": [ "outcome_not_applicable", "alternative_not_selected" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "action", "candidacyId", "state", "reason" ], "additionalProperties": false } ] } ] } } }, "required": [ "items" ], "additionalProperties": false } }, "required": [ "kind", "commandKey", "decision", "preparation" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "command_preview" }, "decision": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "cancelledWork": { "type": "object", "properties": { "generatedInboxTodos": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "candidateWorkflows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "contactPlans": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "generatedInboxTodos", "candidateWorkflows", "contactPlans" ], "additionalProperties": false } }, "required": [ "kind", "stage", "cancelledWork" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false }, "work": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_fact" }, "inputKey": { "type": "string", "enum": [ "command_setup.confirm_interest", "command_setup.present_to_employer" ] }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warnings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] } } }, "required": [ "kind", "inputKey", "declarationStatus", "warnings" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "interview_appointment" }, "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "title": { "type": "string" }, "startsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" }, "locationText": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "participantCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "owner": { "type": "object", "properties": { "membershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" } }, "required": [ "membershipId", "name" ], "additionalProperties": false }, "calendarTarget": { "anyOf": [ { "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provider": { "type": "string", "enum": [ "google", "microsoft" ] } }, "required": [ "name", "provider" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "kind", "inputKey", "title", "startsAt", "endsAt", "timeZone", "locationText", "description", "participantCount", "owner", "calendarTarget" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "interview_coordination" }, "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "host": { "type": "object", "properties": { "membershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "organizationName": { "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "membershipId", "name", "organizationName", "timeZone" ], "additionalProperties": false }, "ruleSource": { "type": "string", "enum": [ "job", "user" ] }, "durationMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "bookingHorizonDays": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "inputKey", "host", "ruleSource", "durationMinutes", "bookingHorizonDays" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "contact_plan" }, "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "plan": { "type": "object", "properties": { "stageName": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "employer_sharing_approval", "interview_coordination" ] }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, "channels": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "address": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "use": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "off" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "permission" }, "basis": { "type": "string", "enum": [ "permission", "staff_override" ] } }, "required": [ "kind", "basis" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "exception" }, "warning": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false } }, "required": [ "kind", "warning" ], "additionalProperties": false } ] } }, "required": [ "channel", "address", "use" ], "additionalProperties": false } }, "steps": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "message" }, "messageKey": { "type": "string", "enum": [ "mobile", "email", "email_reminder" ] }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] }, "channels": { "minItems": 1, "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "fallback": { "type": "boolean" } }, "required": [ "channel", "fallback" ], "additionalProperties": false } } }, "required": [ "kind", "messageKey", "schedule", "channels" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "human_attention" }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] } }, "required": [ "kind", "schedule" ], "additionalProperties": false } ] } }, "omittedMessages": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "messageKey": { "type": "string", "enum": [ "mobile", "email", "email_reminder" ] }, "failure": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "prerequisite_missing" }, "reason": { "type": "string", "enum": [ "processing_basis_missing", "source_no_longer_current", "automation_disabled" ] } }, "required": [ "kind", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "no_usable_channel" }, "channels": { "minItems": 1, "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "reason": { "type": "string", "enum": [ "automation_disabled", "provider_unavailable", "contact_missing", "contact_changed", "permission_missing", "permission_blocked", "permission_withdrawn", "application_inactive", "endpoint_suppressed", "template_missing", "template_not_configured" ] } }, "required": [ "channel", "reason" ], "additionalProperties": false } } }, "required": [ "kind", "channels" ], "additionalProperties": false } ] } }, "required": [ "messageKey", "failure" ], "additionalProperties": false } } }, "required": [ "stageName", "purpose", "channels", "steps", "omittedMessages" ], "additionalProperties": false } }, "required": [ "kind", "inputKey", "plan" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_notice" }, "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "send": { "type": "boolean" }, "recipientAddress": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false } } }, "required": [ "kind", "inputKey", "send", "recipientAddress", "subject", "warnings" ], "additionalProperties": false } ] } }, "commitInputs": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.confirm_interest" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "minLength": 1 }, "declarationException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "minLength": 1 } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "contextFingerprint", "declarationException" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.present_to_employer" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "minLength": 1 }, "declarationException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "minLength": 1 } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "contextFingerprint", "declarationException" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "value": { "type": "object", "properties": { "contextFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "channels": { "maxItems": 3, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "disabled" } }, "required": [ "channel", "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "use_permission" } }, "required": [ "channel", "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "decision": { "type": "string", "const": "permission_exception" }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "channel", "decision", "factsFingerprint" ], "additionalProperties": false } ] } } }, "required": [ "contextFingerprint", "channels" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "value": { "type": "object", "properties": { "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "ruleSource": { "type": "string", "enum": [ "job", "user" ] }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "ownerMembershipId", "ruleSource", "expectedSettingsRevision", "expectedScheduleRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "value": { "type": "object", "properties": { "draft": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "ownerMembershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "startsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" }, "description": { "anyOf": [ { "type": "string", "maxLength": 10000 }, { "type": "null" } ] }, "locationText": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "meetingUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "meetingProvider": { "default": null, "anyOf": [ { "type": "string", "enum": [ "google", "microsoft" ] }, { "type": "null" } ] }, "meetingComparisonKey": { "default": null, "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 128 }, { "type": "null" } ] }, "participants": { "maxItems": 100, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "membership" }, "membershipId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "membershipId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "kind", "candidateId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "external" }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "email": { "anyOf": [ { "type": "string", "maxLength": 320, "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "contact": { "type": "object", "properties": { "engagementContactId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "endpointFingerprint": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "engagementContactId", "endpointFingerprint" ], "additionalProperties": false } }, "required": [ "kind", "name", "email" ], "additionalProperties": false } ] } }, "associations": { "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "recruiting_engagement" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } } }, "required": [ "title", "defaultContentLocale", "ownerMembershipId", "startsAt", "endsAt", "timeZone", "description", "locationText", "meetingUrl", "meetingProvider", "meetingComparisonKey", "participants", "associations" ], "additionalProperties": false }, "operationId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedReviewKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "acknowledgedReasons": { "maxItems": 3, "type": "array", "items": { "type": "string", "enum": [ "calendar_conflict", "appointment_conflict", "calendar_unverified" ] } } }, "required": [ "draft", "operationId", "expectedReviewKey", "acknowledgedReasons" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "value": { "oneOf": [ { "type": "object", "properties": { "send": { "type": "boolean", "const": false } }, "required": [ "send" ], "additionalProperties": false }, { "type": "object", "properties": { "send": { "type": "boolean", "const": true }, "expectedContactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedContactPointRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "email": { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "subject": { "type": "string", "minLength": 1, "maxLength": 998 }, "locale": { "type": "string", "enum": [ "de", "en" ] }, "body": { "type": "object", "properties": { "format": { "type": "string", "const": "html-v1" }, "html": { "type": "string", "maxLength": 200000 } }, "required": [ "format", "html" ], "additionalProperties": false }, "signature": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "none" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "profile" }, "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "mode", "expectedRevision" ], "additionalProperties": false } ] } }, "required": [ "kind", "subject", "locale", "body", "signature" ], "additionalProperties": false }, "permissionException": { "anyOf": [ { "type": "object", "properties": { "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "send", "expectedContactPointId", "expectedContactPointRevision", "email", "permissionException" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_slot_booking" }, "value": { "type": "object", "properties": { "appointmentJobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedAppointmentJobRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedScheduleRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "startsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "displayTimeZone": { "type": "string", "minLength": 1, "maxLength": 64 }, "override": { "anyOf": [ { "type": "object", "properties": { "acknowledgedReasons": { "minItems": 1, "maxItems": 5, "type": "array", "items": { "type": "string", "enum": [ "calendar_conflict", "appointment_conflict", "outside_schedule", "outside_regular_grid", "calendar_unverified" ] } }, "expectedReviewKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "acknowledgedReasons", "expectedReviewKey" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "appointmentJobId", "expectedAppointmentJobRevision", "expectedScheduleRevision", "startsAt", "displayTimeZone", "override" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_sharing_decision" }, "value": { "type": "object", "properties": { "decisionId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "expectedPrivacyRevision": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "decisionId", "expectedPrivacyRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "none" }, "value": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interest_decision" }, "value": { "type": "object", "properties": { "decision": { "type": "string", "enum": [ "granted", "declined" ] }, "declaration": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "existing" }, "decisionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedInterestRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "decisionId", "expectedInterestRevision" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "decision", "declaration" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.resume_collection_resolution" }, "value": { "oneOf": [ { "type": "object", "properties": { "selection": { "type": "string", "const": "existing" }, "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "selection", "documentId", "expectedResumeRevision" ], "additionalProperties": false }, { "type": "object", "properties": { "selection": { "type": "string", "const": "without_resume" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "selection", "expectedResumeRevision" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.qualification_completion" }, "value": { "type": "object", "properties": { "expectedAnswerRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gapHandling": { "type": "string", "enum": [ "require_complete", "accept_with_gaps" ] } }, "required": [ "expectedAnswerRevision", "gapHandling" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_review_decision" }, "value": { "oneOf": [ { "type": "object", "properties": { "decision": { "type": "string", "const": "approved" } }, "required": [ "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "decision": { "type": "string", "const": "rejected" }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "decision", "reason" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_clarification_resolution" }, "value": { "type": "object", "properties": { "resolution": { "type": "string", "enum": [ "continue", "reschedule", "reject", "withdraw" ] }, "expectedAppointmentRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedCalendarIssueRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "resolution", "expectedAppointmentRevision", "expectedCalendarIssueRevision" ], "additionalProperties": false } }, "required": [ "inputKey", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.final_decision" }, "value": { "oneOf": [ { "type": "object", "properties": { "decision": { "type": "string", "const": "hire" } }, "required": [ "decision" ], "additionalProperties": false }, { "type": "object", "properties": { "decision": { "type": "string", "const": "reject" }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "decision", "reason" ], "additionalProperties": false } ] } }, "required": [ "inputKey", "value" ], "additionalProperties": false } ] } }, "preparation": { "type": "object", "properties": { "items": { "type": "array", "items": { "anyOf": [ { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.confirm_interest" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.confirm_interest" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.present_to_employer" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.present_to_employer" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextFingerprint": { "type": "string", "minLength": 1 }, "recorded": { "type": "boolean" }, "declarationStatus": { "type": "string", "enum": [ "granted", "missing", "declined", "withdrawn", "scope_mismatch", "own_employer" ] }, "warning": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "contextFingerprint", "recorded", "declarationStatus", "warning" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_stage" }, "contextFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "candidateName": { "type": "string" }, "jobName": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "stageName": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "employer_sharing_approval", "interview_coordination" ] }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, "routineKey": { "type": "string" }, "channels": { "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "enabled": { "type": "boolean" }, "contactPointId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "contactPointRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "contactValue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "permission": { "type": "string", "enum": [ "allowed", "permission_missing", "permission_withdrawn", "permission_blocked" ] }, "permissionBasis": { "anyOf": [ { "type": "string", "enum": [ "permission", "staff_override" ] }, { "type": "null" } ] }, "permissionScopePurpose": { "anyOf": [ { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, { "type": "null" } ] }, "fallbackChannel": { "type": "boolean" }, "warning": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "contact_missing", "contact_changed", "application_inactive", "endpoint_suppressed", "provider_disabled" ] }, { "type": "null" } ] }, "messageKeys": { "type": "array", "items": { "type": "string" } } }, "required": [ "channel", "enabled", "contactPointId", "contactPointRevision", "permission", "permissionBasis", "warning", "unavailableReason", "messageKeys" ], "additionalProperties": false } }, "steps": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "message" }, "messageKey": { "type": "string", "enum": [ "mobile", "email", "email_reminder" ] }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] }, "channels": { "minItems": 1, "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "fallback": { "type": "boolean" } }, "required": [ "channel", "fallback" ], "additionalProperties": false } } }, "required": [ "kind", "messageKey", "schedule", "channels" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "human_attention" }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] } }, "required": [ "kind", "schedule" ], "additionalProperties": false } ] } } }, "required": [ "kind", "contextFingerprint", "candidacyId", "candidateId", "stageName", "purpose", "routineKey", "channels", "steps" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.contact_plan" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_stage" }, "contextFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "candidateId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "candidateName": { "type": "string" }, "jobName": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "stageName": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "employer_sharing_approval", "interview_coordination" ] }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, "routineKey": { "type": "string" }, "channels": { "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "enabled": { "type": "boolean" }, "contactPointId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "contactPointRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "contactValue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "permission": { "type": "string", "enum": [ "allowed", "permission_missing", "permission_withdrawn", "permission_blocked" ] }, "permissionBasis": { "anyOf": [ { "type": "string", "enum": [ "permission", "staff_override" ] }, { "type": "null" } ] }, "permissionScopePurpose": { "anyOf": [ { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview" ] }, { "type": "null" } ] }, "fallbackChannel": { "type": "boolean" }, "warning": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "null" } ] }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "contact_missing", "contact_changed", "application_inactive", "endpoint_suppressed", "provider_disabled" ] }, { "type": "null" } ] }, "messageKeys": { "type": "array", "items": { "type": "string" } } }, "required": [ "channel", "enabled", "contactPointId", "contactPointRevision", "permission", "permissionBasis", "warning", "unavailableReason", "messageKeys" ], "additionalProperties": false } }, "steps": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "message" }, "messageKey": { "type": "string", "enum": [ "mobile", "email", "email_reminder" ] }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] }, "channels": { "minItems": 1, "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp" ] }, "fallback": { "type": "boolean" } }, "required": [ "channel", "fallback" ], "additionalProperties": false } } }, "required": [ "kind", "messageKey", "schedule", "channels" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "human_attention" }, "schedule": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "after_start" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "after_previous" }, "delaySeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "delaySeconds" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "due" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "kind", "at" ], "additionalProperties": false } ] } }, "required": [ "kind", "schedule" ], "additionalProperties": false } ] } } }, "required": [ "kind", "contextFingerprint", "candidacyId", "candidateId", "stageName", "purpose", "routineKey", "channels", "steps" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "candidacyId", "jobId" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_appointment" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "candidacyId", "jobId" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "withdrawal", "rejection", "hiring" ] }, "recipient": { "anyOf": [ { "type": "object", "properties": { "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "address": { "type": "string" } }, "required": [ "contactPointId", "revision", "address" ], "additionalProperties": false }, { "type": "null" } ] }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false } }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "no_email_contact", "endpoint_suppressed", "delivery_unavailable" ] }, { "type": "null" } ] }, "draft": { "type": "object", "properties": { "subject": { "type": "string", "maxLength": 998 }, "html": { "type": "string", "maxLength": 200000 }, "locale": { "type": "string", "enum": [ "de", "en" ] } }, "required": [ "subject", "html", "locale" ], "additionalProperties": false }, "sender": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "member_mailbox" }, "address": { "type": "string" } }, "required": [ "kind", "address" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "platform" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "signature": { "anyOf": [ { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedRevision" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "kind", "recipient", "warnings", "unavailableReason", "draft", "sender", "signature" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.candidacy_notice" }, "context": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "withdrawal", "rejection", "hiring" ] }, "recipient": { "anyOf": [ { "type": "object", "properties": { "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "address": { "type": "string" } }, "required": [ "contactPointId", "revision", "address" ], "additionalProperties": false }, { "type": "null" } ] }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false } }, "unavailableReason": { "anyOf": [ { "type": "string", "enum": [ "no_email_contact", "endpoint_suppressed", "delivery_unavailable" ] }, { "type": "null" } ] }, "draft": { "type": "object", "properties": { "subject": { "type": "string", "maxLength": 998 }, "html": { "type": "string", "maxLength": 200000 }, "locale": { "type": "string", "enum": [ "de", "en" ] } }, "required": [ "subject", "html", "locale" ], "additionalProperties": false }, "sender": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "member_mailbox" }, "address": { "type": "string" } }, "required": [ "kind", "address" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "platform" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "signature": { "anyOf": [ { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedRevision" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "kind", "recipient", "warnings", "unavailableReason", "draft", "sender", "signature" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "context": { "type": "object", "properties": { "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "jobSchedule": { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "rules": { "type": "object", "properties": { "timeZone": { "type": "string" }, "weeklyHours": { "minItems": 7, "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "day": { "type": "integer", "minimum": 1, "maximum": 7 }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "day", "windows" ], "additionalProperties": false } }, "dateSpecificHours": { "maxItems": 730, "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "date", "windows" ], "additionalProperties": false } } }, "required": [ "timeZone", "weeklyHours", "dateSpecificHours" ], "additionalProperties": false } }, "required": [ "revision", "rules" ], "additionalProperties": false }, "durationMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "bookingHorizonDays": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "jobId", "expectedSettingsRevision", "jobSchedule", "durationMinutes", "bookingHorizonDays" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "command_setup.interview_coordination" }, "context": { "type": "object", "properties": { "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedSettingsRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "jobSchedule": { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "rules": { "type": "object", "properties": { "timeZone": { "type": "string" }, "weeklyHours": { "minItems": 7, "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "day": { "type": "integer", "minimum": 1, "maximum": 7 }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "day", "windows" ], "additionalProperties": false } }, "dateSpecificHours": { "maxItems": 730, "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "windows": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "startMinute": { "type": "integer", "minimum": 0, "maximum": 1439 }, "endMinute": { "type": "integer", "minimum": 1, "maximum": 1440 } }, "required": [ "startMinute", "endMinute" ], "additionalProperties": false } } }, "required": [ "date", "windows" ], "additionalProperties": false } } }, "required": [ "timeZone", "weeklyHours", "dateSpecificHours" ], "additionalProperties": false } }, "required": [ "revision", "rules" ], "additionalProperties": false }, "durationMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "bookingHorizonDays": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "jobId", "expectedSettingsRevision", "jobSchedule", "durationMinutes", "bookingHorizonDays" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_slot_booking" }, "context": { "type": "object", "properties": { "appointmentJobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "appointmentJobRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "durationMinutes": { "type": "integer", "minimum": 5, "maximum": 480 }, "bookingWindow": { "type": "object", "properties": { "opensAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" } }, "required": [ "opensAt", "closesAt", "timeZone" ], "additionalProperties": false }, "scheduleTimeZone": { "type": "string" }, "ownerName": { "type": "string" }, "ownerPhoto": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "version" ], "additionalProperties": false }, { "type": "null" } ] }, "organizationName": { "type": "string" }, "organizationLogoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organizationSymbolUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "canOverride": { "type": "boolean" }, "status": { "type": "string", "enum": [ "open", "booked", "expired", "unavailable" ] } }, "required": [ "appointmentJobId", "appointmentJobRevision", "title", "defaultContentLocale", "durationMinutes", "bookingWindow", "scheduleTimeZone", "ownerName", "ownerPhoto", "organizationName", "organizationLogoUrl", "organizationSymbolUrl", "canOverride", "status" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_slot_booking" }, "context": { "type": "object", "properties": { "appointmentJobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "appointmentJobRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "title": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false }, "defaultContentLocale": { "type": "string", "enum": [ "de", "en" ] }, "durationMinutes": { "type": "integer", "minimum": 5, "maximum": 480 }, "bookingWindow": { "type": "object", "properties": { "opensAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timeZone": { "type": "string" } }, "required": [ "opensAt", "closesAt", "timeZone" ], "additionalProperties": false }, "scheduleTimeZone": { "type": "string" }, "ownerName": { "type": "string" }, "ownerPhoto": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "version" ], "additionalProperties": false }, { "type": "null" } ] }, "organizationName": { "type": "string" }, "organizationLogoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organizationSymbolUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "canOverride": { "type": "boolean" }, "status": { "type": "string", "enum": [ "open", "booked", "expired", "unavailable" ] } }, "required": [ "appointmentJobId", "appointmentJobRevision", "title", "defaultContentLocale", "durationMinutes", "bookingWindow", "scheduleTimeZone", "ownerName", "ownerPhoto", "organizationName", "organizationLogoUrl", "organizationSymbolUrl", "canOverride", "status" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.resume_collection_resolution" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "resume": { "anyOf": [ { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "origin": { "type": "string", "enum": [ "profile_adoption", "candidate_upload", "inbound_message", "candidate_selection", "staff_upload", "staff_profile_adoption" ] }, "assignedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "document": { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false } }, "required": [ "revision", "origin", "assignedAt", "document" ], "additionalProperties": false }, { "type": "null" } ] }, "profileResume": { "anyOf": [ { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false }, { "type": "null" } ] }, "canEdit": { "type": "boolean" }, "canSetProfile": { "type": "boolean" } }, "required": [ "candidacyId", "expectedResumeRevision", "resume", "profileResume", "canEdit", "canSetProfile" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.resume_collection_resolution" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedResumeRevision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "resume": { "anyOf": [ { "type": "object", "properties": { "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "origin": { "type": "string", "enum": [ "profile_adoption", "candidate_upload", "inbound_message", "candidate_selection", "staff_upload", "staff_profile_adoption" ] }, "assignedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "document": { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false } }, "required": [ "revision", "origin", "assignedAt", "document" ], "additionalProperties": false }, { "type": "null" } ] }, "profileResume": { "anyOf": [ { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "documentId", "mediaType", "sizeBytes", "availableAt" ], "additionalProperties": false }, { "type": "null" } ] }, "canEdit": { "type": "boolean" }, "canSetProfile": { "type": "boolean" } }, "required": [ "candidacyId", "expectedResumeRevision", "resume", "profileResume", "canEdit", "canSetProfile" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.qualification_completion" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "questionnaireRevisionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedAnswerRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "questionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "answeredQuestionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missingRequiredQuestionIds": { "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "completionRuleViolation": { "anyOf": [ { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "unknown_question", "duplicate_question", "kind_mismatch", "empty_text", "text_too_long", "invalid_value" ] }, "questionKey": { "type": "string" } }, "required": [ "reason", "questionKey" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "questionnaireRevisionId", "expectedAnswerRevision", "questionCount", "answeredQuestionCount", "missingRequiredQuestionIds", "completionRuleViolation" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.qualification_completion" }, "context": { "type": "object", "properties": { "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "jobId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "questionnaireRevisionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "expectedAnswerRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "questionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "answeredQuestionCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missingRequiredQuestionIds": { "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "completionRuleViolation": { "anyOf": [ { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "unknown_question", "duplicate_question", "kind_mismatch", "empty_text", "text_too_long", "invalid_value" ] }, "questionKey": { "type": "string" } }, "required": [ "reason", "questionKey" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "candidacyId", "jobId", "questionnaireRevisionId", "expectedAnswerRevision", "questionCount", "answeredQuestionCount", "missingRequiredQuestionIds", "completionRuleViolation" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_review_decision" }, "context": { "type": "object", "properties": { "decision": { "anyOf": [ { "type": "string", "const": "approved" }, { "type": "null" } ] } }, "required": [ "decision" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.employer_review_decision" }, "context": { "type": "object", "properties": { "decision": { "anyOf": [ { "type": "string", "const": "approved" }, { "type": "null" } ] } }, "required": [ "decision" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_clarification_resolution" }, "context": { "type": "object", "properties": { "expectedAppointmentRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedCalendarIssueRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reason": { "type": "string", "enum": [ "calendar_entry_deleted", "calendar_entry_missing", "calendar_interval_invalid", "calendar_change_not_applicable", "appointment_cancelled" ] } }, "required": [ "expectedAppointmentRevision", "expectedCalendarIssueRevision", "endsAt", "reason" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.interview_clarification_resolution" }, "context": { "type": "object", "properties": { "expectedAppointmentRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expectedCalendarIssueRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "endsAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reason": { "type": "string", "enum": [ "calendar_entry_deleted", "calendar_entry_missing", "calendar_interval_invalid", "calendar_change_not_applicable", "appointment_cancelled" ] } }, "required": [ "expectedAppointmentRevision", "expectedCalendarIssueRevision", "endsAt", "reason" ], "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.final_decision" }, "context": { "type": "object", "properties": {}, "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "state": { "type": "string", "const": "required" } }, "required": [ "inputKey", "context", "id", "dependsOnInputKeys", "kind", "possibleConsequences", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "inputKey": { "type": "string", "const": "stage_command.final_decision" }, "context": { "type": "object", "properties": {}, "additionalProperties": false }, "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "state": { "type": "string", "const": "satisfied" }, "source": { "type": "string", "enum": [ "input", "record" ] } }, "required": [ "inputKey", "id", "dependsOnInputKeys", "kind", "state", "source" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "inputKey": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] }, "state": { "type": "string", "enum": [ "conditional", "waiting" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "possibleConsequences", "inputKey", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "command_input_form" }, "possibleConsequences": { "type": "array", "items": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "terminal" }, "lifecycle": { "type": "string", "enum": [ "hired", "closed" ] }, "closureReason": { "anyOf": [ { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] }, { "type": "null" } ] } }, "required": [ "kind", "lifecycle", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "depends_on_input" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "effects": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_completed" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "appointment_cancelled" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_passed_through" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_entered" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false }, "alreadySatisfied": { "type": "string", "enum": [ "interest_confirmed", "application_resume_available", "qualification_answers_submitted", "qualification_answers_from_resume", "presented_to_employer", "employer_presentation_ready" ] } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "inbox_work_created" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_presented_to_employer" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_closed" }, "closureReason": { "type": "string", "enum": [ "recruiter_rejected", "candidate_withdrawn", "interest_declined", "employer_sharing_declined", "employer_rejected", "job_filled", "job_closed", "candidate_personal_data_erased", "candidate_erasure_requested", "recruiting_responsibility_changed" ] } }, "required": [ "kind", "closureReason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy_hired" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "stage_work_cancelled" }, "stage": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "interest_confirmation", "resume_collection", "qualification", "recruiter_review", "employer_sharing_approval", "employer_review", "interview_coordination", "interview", "final_decision" ] }, "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "name", "version" ], "additionalProperties": false } }, "required": [ "kind", "stage" ], "additionalProperties": false } ] } } }, "required": [ "target", "effects" ], "additionalProperties": false } }, "inputKey": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] }, "state": { "type": "string", "const": "not_applicable" }, "reason": { "type": "string", "enum": [ "outcome_not_applicable", "alternative_not_selected" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "possibleConsequences", "inputKey", "state", "reason" ], "additionalProperties": false } ] }, { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "optional_record_action" }, "action": { "type": "string", "enum": [ "review_application_contact" ] }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "state": { "type": "string", "enum": [ "conditional", "waiting", "available" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "action", "candidacyId", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "dependsOnInputKeys": { "type": "array", "items": { "anyOf": [ { "type": "string", "const": "command_setup.confirm_interest" }, { "type": "string", "const": "command_setup.present_to_employer" }, { "type": "string", "const": "command_setup.contact_plan" }, { "type": "string", "const": "command_setup.interview_appointment" }, { "type": "string", "const": "command_setup.candidacy_notice" }, { "type": "string", "const": "command_setup.interview_coordination" }, { "type": "string", "const": "stage_command.interview_slot_booking" }, { "type": "string", "const": "stage_command.resume_collection_resolution" }, { "type": "string", "const": "stage_command.qualification_completion" }, { "type": "string", "const": "stage_command.employer_review_decision" }, { "type": "string", "const": "stage_command.interview_clarification_resolution" }, { "type": "string", "const": "stage_command.final_decision" } ] } }, "kind": { "type": "string", "const": "optional_record_action" }, "action": { "type": "string", "enum": [ "review_application_contact" ] }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "state": { "type": "string", "const": "not_applicable" }, "reason": { "type": "string", "enum": [ "outcome_not_applicable", "alternative_not_selected" ] } }, "required": [ "id", "dependsOnInputKeys", "kind", "action", "candidacyId", "state", "reason" ], "additionalProperties": false } ] } ] } } }, "required": [ "items" ], "additionalProperties": false }, "confirmation": { "anyOf": [ { "type": "object", "properties": { "previewFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "warnings": { "readOnly": true, "maxItems": 1500, "type": "array", "items": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "interest_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "employer_sharing_declaration" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string", "enum": [ "missing", "declined", "withdrawn", "scope_mismatch" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidacyId", "reason", "factsFingerprint" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_contact" }, "candidateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contactPointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "channel": { "type": "string", "enum": [ "email", "sms", "whatsapp", "voice_call" ] }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "candidate_general" }, "purpose": { "type": "string", "enum": [ "candidate_correspondence", "future_job_offers" ] } }, "required": [ "kind", "purpose" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "candidacy" }, "candidacyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "purpose": { "type": "string", "enum": [ "recruiting_interest", "application_documents", "application_qualification", "employer_sharing_approval", "application_interview", "application_correspondence" ] } }, "required": [ "kind", "candidacyId", "purpose" ], "additionalProperties": false } ] }, "reason": { "type": "string", "enum": [ "permission_missing", "permission_withdrawn", "permission_blocked", "endpoint_opt_out" ] }, "factsFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "candidateId", "contactPointId", "channel", "scope", "reason", "factsFingerprint" ], "additionalProperties": false } ] } } }, "required": [ "previewFingerprint", "warnings" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "kind", "decision", "work", "commitInputs", "preparation", "confirmation" ], "additionalProperties": false } ] } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "manage" } } }, "/v1/hiring-process/applications/{applicationId}/resume": { "get": { "operationId": "getApplicationResume", "summary": "Bewerbungslebenslauf lesen", "description": "Liefert den aktuellen Bewerbungslebenslauf mit Downloadadresse und Revision. Ist kein Lebenslauf hinterlegt, ist document null.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "document": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "mediaType": { "type": "string" }, "sizeBytes": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "downloadUrl": { "type": "string", "pattern": "^\\/v1\\/hiring-process\\/applications\\/.*" } }, "required": [ "id", "mediaType", "sizeBytes", "downloadUrl" ], "additionalProperties": false }, { "type": "null" } ] }, "revision": { "type": "string" } }, "required": [ "document", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } }, "put": { "operationId": "uploadApplicationResume", "summary": "Bewerbungslebenslauf übernehmen", "description": "Übernimmt einen hochgeladenen Lebenslauf für die Bewerbung. Senden Sie file und JSON-Metadaten mit expectedRevision als multipart/form-data. Mit alsoSetProfile kann die Datei zusätzlich als Profillebenslauf übernommen werden, sofern dies erlaubt ist.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "metadata": { "type": "string", "description": "JSON: expectedRevision, alsoSetProfile (default false)" }, "file": { "type": "string", "contentEncoding": "binary" } }, "required": [ "metadata", "file" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "413": { "description": "Upload überschreitet die Größenbegrenzung (payload_too_large).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Datei- oder Inhaltstyp wird nicht unterstützt (unsupported_media_type).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "manage" } } }, "/v1/hiring-process/applications/{applicationId}/resume/content": { "get": { "operationId": "getApplicationResumeContent", "summary": "Bewerbungslebenslauf herunterladen", "description": "Lädt den aktuellen Lebenslauf der Bewerbung herunter. Das Bewerbungsleserecht und eine gültige Freigabe genügen; ein zusätzliches Kandidatenleserecht ist nicht erforderlich.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Aktueller Bewerbungslebenslauf", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Inhalt nicht mehr verfügbar oder Synchronisierung neu beginnen (resync_required).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } } }, "/v1/hiring-process/applications/{applicationId}/resume/adopt-profile": { "post": { "operationId": "adoptApplicationProfileResume", "summary": "Profillebenslauf übernehmen", "description": "Übernimmt den vorhandenen Profillebenslauf als Bewerbungslebenslauf. Geben Sie die aktuelle Dokument-ID und expectedRevision an.", "tags": [ "Hiring Process" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expectedRevision": { "type": "string", "minLength": 1 }, "profileDocumentId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "expectedRevision", "profileDocumentId" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "manage" } } }, "/v1/members": { "get": { "operationId": "listMembers", "summary": "Zuständige Personen auswählen", "description": "Liefert IDs und Anzeigenamen aktiver Benutzer Ihrer Organisation, zum Beispiel für die Zuständigkeit einer Aufgabe. Benötigt Leserechte in mindestens einem der unterstützten Fachbereiche.", "tags": [ "Reference data" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } } ], "responses": { "200": { "description": "Aktive Personen und nächster Cursor", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/categories": { "get": { "operationId": "listCategories", "summary": "Kategorien auswählen", "description": "Liefert auswählbare Kategorien und die Standardkategorie für Notizen, Aufgaben oder Anrufe. Geben Sie den gewünschten Bereich an; der API-Zugang benötigt das zugehörige Leserecht.", "tags": [ "Reference data" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "resourceType", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "note", "task", "call" ] } } ], "responses": { "200": { "description": "Auswählbare Kategorien", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false } }, "defaultCategoryId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": [ "items", "defaultCategoryId" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/notes": { "get": { "operationId": "listNotes", "summary": "Notizen auflisten", "description": "Listet lesbare interne Notizen mit Inhalt, Kategorie und verfügbaren Zuordnungen auf. Verwenden Sie nextCursor für weitere Ergebnisse.", "tags": [ "Notes" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "categoryId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "content": { "type": "object", "properties": { "html": { "type": "string" }, "text": { "type": "string" } }, "required": [ "html", "text" ], "additionalProperties": false }, "associations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } }, "revision": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "categoryId", "content", "associations", "revision", "createdAt", "updatedAt" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.notes", "level": "view" } }, "post": { "operationId": "createNote", "summary": "Notiz anlegen", "description": "Legt eine interne Notiz mit HTML-Inhalt und mindestens einer Zuordnung an. Erlaubte Ziele sind Kandidaten, Stellen und Kundenunternehmen. Ohne categoryId wird die Standardkategorie verwendet.", "tags": [ "Notes" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "categoryId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "content": { "type": "object", "properties": { "html": { "type": "string", "minLength": 1, "maxLength": 200000 } }, "required": [ "html" ], "additionalProperties": false }, "associations": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } } }, "required": [ "content", "associations" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.notes", "level": "manage" } } }, "/v1/notes/{noteId}": { "get": { "operationId": "getNote", "summary": "Notiz lesen", "description": "Liefert Inhalt, Kategorie und verfügbare Zuordnungen einer internen Notiz. Der API-Zugang benötigt Zugriff auf mindestens einen zugeordneten Datensatz.", "tags": [ "Notes" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "noteId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "categoryId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "content": { "type": "object", "properties": { "html": { "type": "string" }, "text": { "type": "string" } }, "required": [ "html", "text" ], "additionalProperties": false }, "associations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } }, "revision": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "categoryId", "content", "associations", "revision", "createdAt", "updatedAt" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.notes", "level": "view" } } }, "/v1/tasks": { "get": { "operationId": "listTasks", "summary": "Aufgaben auflisten", "description": "Listet manuell angelegte Todos mit Checkliste, Zuständigkeit und Fälligkeit auf. Automatisch erzeugte Aufgaben des Bewerbungsprozesses sind nicht Bestandteil dieser Liste.", "tags": [ "Tasks" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "title": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "categoryId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "assigneeMemberId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "priority": { "type": "string", "enum": [ "low", "normal", "high" ] }, "status": { "type": "string", "enum": [ "open", "completed", "dismissed", "cancelled" ] }, "dueDate": { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "null" } ] }, "dueTimeZone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checklist": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "title": { "type": "string" }, "completed": { "type": "boolean" } }, "required": [ "id", "title", "completed" ], "additionalProperties": false } }, "associations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } }, "revision": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "title", "description", "categoryId", "assigneeMemberId", "priority", "status", "dueDate", "dueTimeZone", "checklist", "associations", "revision", "createdAt", "updatedAt" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.inbox", "level": "view" } }, "post": { "operationId": "createTask", "summary": "Aufgabe anlegen", "description": "Legt ein manuelles Todo mit Kategorie und mindestens einem Checklistenpunkt an. Optional können Sie eine zuständige Person, Fälligkeit, Priorität und Zuordnungen angeben.", "tags": [ "Tasks" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "idempotency-key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 300 }, "description": { "default": null, "anyOf": [ { "type": "string", "maxLength": 10000 }, { "type": "null" } ] }, "categoryId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assigneeMemberId": { "default": null, "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "priority": { "default": "normal", "type": "string", "enum": [ "low", "normal", "high" ] }, "dueDate": { "default": null, "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "null" } ] }, "checklist": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 300 }, "completed": { "default": false, "type": "boolean" } }, "required": [ "title" ], "additionalProperties": false } }, "associations": { "default": [], "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } } }, "required": [ "title", "categoryId", "checklist" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" } }, "required": [ "type", "id", "url" ], "additionalProperties": false }, "revision": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "erased", "restricted", "unchanged" ] } }, "required": [ "resource", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Konflikt: confirmation_required, revision_conflict, idempotency_conflict oder request_in_progress. Vorschau und Eingaben erneut prüfen; laufende Aufträge mit demselben Idempotenzschlüssel wiederholen.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.inbox", "level": "manage" } } }, "/v1/tasks/{taskId}": { "get": { "operationId": "getTask", "summary": "Aufgabe lesen", "description": "Liefert ein manuelles Todo mit Checkliste, Status, Planung und Zuordnungen.", "tags": [ "Tasks" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "title": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "categoryId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "assigneeMemberId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "priority": { "type": "string", "enum": [ "low", "normal", "high" ] }, "status": { "type": "string", "enum": [ "open", "completed", "dismissed", "cancelled" ] }, "dueDate": { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "null" } ] }, "dueTimeZone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checklist": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "title": { "type": "string" }, "completed": { "type": "boolean" } }, "required": [ "id", "title", "completed" ], "additionalProperties": false } }, "associations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } }, "revision": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "title", "description", "categoryId", "assigneeMemberId", "priority", "status", "dueDate", "dueTimeZone", "checklist", "associations", "revision", "createdAt", "updatedAt" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.inbox", "level": "view" } } }, "/v1/calls": { "get": { "operationId": "listCalls", "summary": "Anrufe auflisten", "description": "Listet protokollierte Anrufe auf, die der API-Zugang lesen darf. Enthält Richtung, Ergebnis, Zeitangaben und verfügbare Zuordnungen.", "tags": [ "Calls" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096 } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "categoryId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "direction": { "type": "string", "enum": [ "inbound", "outbound" ] }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "endedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "connected", "no_answer", "busy", "cancelled", "failed" ] }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "forMemberId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "associations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } }, "revision": { "type": "string" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "categoryId", "direction", "startedAt", "endedAt", "outcome", "notes", "forMemberId", "associations", "revision", "occurredAt" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.communications", "level": "view" } } }, "/v1/calls/{callId}": { "get": { "operationId": "getCall", "summary": "Anruf lesen", "description": "Liefert Details eines protokollierten Anrufs, einschließlich Ergebnis, Notizen und verfügbaren Zuordnungen.", "tags": [ "Calls" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "callId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Erfolgreich", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "categoryId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "direction": { "type": "string", "enum": [ "inbound", "outbound" ] }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "endedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "outcome": { "type": "string", "enum": [ "connected", "no_answer", "busy", "cancelled", "failed" ] }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "forMemberId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "associations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "job", "company" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "type", "id" ], "additionalProperties": false } }, "revision": { "type": "string" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "categoryId", "direction", "startedAt", "endedAt", "outcome", "notes", "forMemberId", "associations", "revision", "occurredAt" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.communications", "level": "view" } } }, "/v1/record-schemas/{resourceType}": { "get": { "operationId": "getRecordSchema", "summary": "Feldschema lesen", "description": "Beschreibt die Felder für Kandidaten, Unternehmen oder Stellen: Typen, Pflichtangaben, Optionen und Unterstützung durch die API. Verwenden Sie Feld-IDs, um benutzerdefinierte Werte zu lesen oder zu schreiben.", "tags": [ "record-schemas" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "resourceType", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "candidate", "company", "job" ] } } ], "responses": { "200": { "description": "Aktuelle Feldkonfiguration", "content": { "application/json": { "schema": { "type": "object", "properties": { "configurationId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "fields": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "origin": { "type": "string", "enum": [ "native", "custom" ] }, "type": { "type": "string" }, "label": { "anyOf": [ { "type": "object", "properties": { "fallback": { "type": "string" }, "translations": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false } }, "required": [ "fallback", "translations" ], "additionalProperties": false }, { "type": "null" } ] }, "required": { "type": "boolean" }, "writable": { "type": "boolean" }, "supported": { "type": "boolean" }, "groupFieldId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "settings": { "type": "object", "properties": { "maxLength": { "type": "number" }, "number": { "type": "object", "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "scale": { "type": "number" }, "integerDigits": { "type": "number" } }, "required": [ "scale", "integerDigits" ], "additionalProperties": false }, "codes": { "type": "array", "items": { "type": "string" } }, "minEntries": { "anyOf": [ { "type": "number", "const": 0 }, { "type": "number", "const": 1 } ] } }, "additionalProperties": false }, "options": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "label": { "type": "object", "properties": { "fallback": { "type": "string" }, "translations": { "type": "object", "properties": { "de": { "type": "string" }, "en": { "type": "string" } }, "additionalProperties": false } }, "required": [ "fallback", "translations" ], "additionalProperties": false }, "retired": { "type": "boolean" } }, "required": [ "id", "label", "retired" ], "additionalProperties": false } } }, "required": [ "id", "key", "origin", "type", "label", "required", "writable", "supported", "groupFieldId", "settings", "options" ], "additionalProperties": false } } }, "required": [ "configurationId", "revision", "fields" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/events": { "get": { "operationId": "listEvents", "summary": "Änderungen nachholen", "description": "Liefert Änderungsereignisse der letzten 30 Tage. Starten Sie mit since oder einem gespeicherten Cursor und übernehmen Sie nextCursor für den nächsten Abruf. Bei 410 resync_required ist ein vollständiger Neuabgleich erforderlich.", "tags": [ "Synchronization" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } }, { "name": "since", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } } ], "responses": { "200": { "description": "Ereignisse und nächster Cursor", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "enum": [ "candidate.created", "candidate.updated", "candidate.removed", "company.created", "company.updated", "company.removed", "contact.created", "contact.updated", "contact.removed", "job.created", "job.updated", "job.status_changed", "job.removed", "hiring_process.application.created", "hiring_process.application.updated", "hiring_process.application.stage_changed", "hiring_process.application.removed", "note.created", "note.updated", "note.removed", "task.created", "task.updated", "task.removed", "call.recorded", "call.updated", "call.removed" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } }, "nextCursor": { "type": "string" }, "hasMore": { "type": "boolean" } }, "required": [ "items", "nextCursor", "hasMore" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Inhalt nicht mehr verfügbar oder Synchronisierung neu beginnen (resync_required).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/events/checkpoint": { "get": { "operationId": "getEventCheckpoint", "summary": "Abgleich vorbereiten", "description": "Liefert einen Startcursor für die Vollsynchronisierung. Rufen Sie ihn vor dem Lesen der Ressourcenlisten ab und holen Sie anschließend Änderungen ab diesem Cursor nach.", "tags": [ "Synchronization" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Gebundener Startcursor", "content": { "application/json": { "schema": { "type": "object", "properties": { "cursor": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "cursor", "createdAt" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/events/{eventId}": { "get": { "operationId": "getEvent", "summary": "Ereignis lesen", "description": "Liefert eine einzelne Ereignismitteilung innerhalb der 30-tägigen Aufbewahrungsfrist. Die Ressourcenadresse verweist auf den aktuellen Datensatz. Nicht verfügbare Ereignisse liefern 404.", "tags": [ "Synchronization" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "eventId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Ereignisreferenz", "content": { "application/json": { "schema": { "type": "object", "properties": { "event": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "enum": [ "candidate.created", "candidate.updated", "candidate.removed", "company.created", "company.updated", "company.removed", "contact.created", "contact.updated", "contact.removed", "job.created", "job.updated", "job.status_changed", "job.removed", "hiring_process.application.created", "hiring_process.application.updated", "hiring_process.application.stage_changed", "hiring_process.application.removed", "note.created", "note.updated", "note.removed", "task.created", "task.updated", "task.removed", "call.recorded", "call.updated", "call.removed" ] }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } }, "required": [ "event" ], "additionalProperties": false } } } }, "400": { "description": "Ungültige Anfrage oder ungültiger Cursor (bad_request).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "API-Schlüssel fehlt oder ist ungültig (unauthorized).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Das erforderliche Recht fehlt (forbidden).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Datensatz fehlt oder ist nicht zugänglich (not_found).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Fachlich ungültige Werte (validation_failed); Feldhinweise stehen in error.details.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Aufruflimit erreicht (rate_limited). Retry-After beachten.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unerwarteter interner Fehler (internal_error). x-request-id für Support aufbewahren.", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Vorübergehend nicht verfügbar (service_unavailable).", "headers": { "x-request-id": { "description": "Kennung für Supportanfragen", "schema": { "type": "string" } }, "Retry-After": { "description": "Falls vorhanden: Wartezeit in Sekunden vor einer technischen Wiederholung", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } } }, "webhooks": { "candidate.created": { "post": { "operationId": "receive_candidate_created", "summary": "candidate.created", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "candidate.created" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "candidate.updated": { "post": { "operationId": "receive_candidate_updated", "summary": "candidate.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "candidate.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "candidate.removed": { "post": { "operationId": "receive_candidate_removed", "summary": "candidate.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "candidate.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "company.created": { "post": { "operationId": "receive_company_created", "summary": "company.created", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "company.created" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "company.updated": { "post": { "operationId": "receive_company_updated", "summary": "company.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "company.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "company.removed": { "post": { "operationId": "receive_company_removed", "summary": "company.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "company.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "contact.created": { "post": { "operationId": "receive_contact_created", "summary": "contact.created", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "contact.created" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "contact.updated": { "post": { "operationId": "receive_contact_updated", "summary": "contact.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "contact.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "contact.removed": { "post": { "operationId": "receive_contact_removed", "summary": "contact.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "contact.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "job.created": { "post": { "operationId": "receive_job_created", "summary": "job.created", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "job.created" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "job.updated": { "post": { "operationId": "receive_job_updated", "summary": "job.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "job.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "job.status_changed": { "post": { "operationId": "receive_job_status_changed", "summary": "job.status_changed", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "job.status_changed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "job.removed": { "post": { "operationId": "receive_job_removed", "summary": "job.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "job.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "hiring_process.application.created": { "post": { "operationId": "receive_hiring_process_application_created", "summary": "hiring_process.application.created", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "hiring_process.application.created" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "hiring_process.application.updated": { "post": { "operationId": "receive_hiring_process_application_updated", "summary": "hiring_process.application.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "hiring_process.application.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "hiring_process.application.stage_changed": { "post": { "operationId": "receive_hiring_process_application_stage_changed", "summary": "hiring_process.application.stage_changed", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "hiring_process.application.stage_changed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "hiring_process.application.removed": { "post": { "operationId": "receive_hiring_process_application_removed", "summary": "hiring_process.application.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "hiring_process.application.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "note.created": { "post": { "operationId": "receive_note_created", "summary": "note.created", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "note.created" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "note.updated": { "post": { "operationId": "receive_note_updated", "summary": "note.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "note.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "note.removed": { "post": { "operationId": "receive_note_removed", "summary": "note.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "note.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "task.created": { "post": { "operationId": "receive_task_created", "summary": "task.created", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "task.created" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "task.updated": { "post": { "operationId": "receive_task_updated", "summary": "task.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "task.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "task.removed": { "post": { "operationId": "receive_task_removed", "summary": "task.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "task.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "call.recorded": { "post": { "operationId": "receive_call_recorded", "summary": "call.recorded", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "call.recorded" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "call.updated": { "post": { "operationId": "receive_call_updated", "summary": "call.updated", "description": "Rufen Sie resource.url auf, um den aktuellen Datensatz zu lesen. Das Ereignis enthält keine Kopie der geänderten Daten; der Datensatz kann inzwischen erneut geändert worden sein. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "call.updated" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "call.removed": { "post": { "operationId": "receive_call_removed", "summary": "call.removed", "description": "Die Ressource ist für diesen API-Zugang nicht mehr verfügbar. Aktualisieren Sie Ihren lokalen Bestand entsprechend; ein Abruf der Ressourcenadresse kann bereits 404 liefern. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "call.removed" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "publishedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" }, "resource": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "candidate", "company", "contact", "job", "application", "note", "task", "call" ] }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "url": { "type": "string" } }, "required": [ "type", "id", "url" ], "additionalProperties": false } }, "required": [ "id", "type", "occurredAt", "publishedAt", "apiVersion", "resource" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } }, "webhook.test": { "post": { "operationId": "receive_webhook_test", "summary": "webhook.test", "description": "Prüft Ihren Webhook-Empfänger. Dieses Testereignis enthält keine Ressourcenreferenz und erfordert keinen API-Abruf. Prüfen Sie die Standard-Webhooks-Signatur anhand der unveränderten Request-Bytes und mit fünf Minuten Zeitstempeltoleranz. Erkennen Sie Duplikate über webhook-id und antworten Sie nach dauerhaftem Vormerken mit 2xx. Zustellungen können mehrfach und in anderer Reihenfolge eintreffen.", "parameters": [ { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "HMAC-SHA256-Signatur im Format v1,. Signierte Bytes: ... Während eines Geheimniswechsels können mehrere Signaturen enthalten sein." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "type": { "type": "string", "const": "webhook.test" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "apiVersion": { "type": "string", "const": "v1" } }, "required": [ "id", "type", "occurredAt", "apiVersion" ], "additionalProperties": false } } } }, "responses": { "2XX": { "description": "Dauerhaft angenommen; keine Wiederholung nötig" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "Mission Work API key" } }, "schemas": { "ApiError": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "message_asset_unavailable", "message_asset_provider_unavailable", "message_asset_provider_reauthorization_required", "message_asset_download_too_large", "bad_request", "unauthorized", "forbidden", "not_found", "conflict", "payload_too_large", "unsupported_media_type", "internal_error", "service_unavailable", "rate_limited", "revision_conflict", "idempotency_conflict", "request_in_progress", "resync_required", "validation_failed", "confirmation_required" ] }, "message": { "type": "string", "minLength": 1, "maxLength": 1000 }, "details": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "validation" }, "fields": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } } }, "required": [ "kind", "fields" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "resync" }, "reason": { "type": "string", "enum": [ "retention_expired", "permissions_changed" ] } }, "required": [ "kind", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "confirmation" }, "previewRequired": { "type": "boolean", "const": true } }, "required": [ "kind", "previewRequired" ], "additionalProperties": false } ] } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }