{ "openapi": "3.1.0", "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "info": { "title": "Mission Work API", "version": "v1", "description": "# Connect to Mission Work\n\nUse the Mission Work API to connect your systems to your recruiting in Mission Work. Manage candidates, customer companies and jobs, work with applications, and receive change notifications through webhooks.\n\nThe base URL is `https://api.work.mission-personal.org/v1`. This guide covers setup and common workflows. The API reference that follows describes the parameters and responses for each operation.\n\n## API access and your first request\n\n1. In Mission Work, open Admin Settings → Access management → API access.\n2. Create an access and choose a role with the permissions your integration needs.\n3. Store the API key shown after creation securely on your server.\n\nSend the key with every request in the header `Authorization: Bearer `. Use HTTPS and keep keys out of URLs, publicly accessible code and logs.\n\nUse this request to verify the key and retrieve its organization and current permissions:\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\nThis endpoint works even if the access has not yet been granted permissions for records. Other operations require the permissions listed in the reference. Role changes take effect on the next request.\n\nYou can revoke or rotate keys. Up to two keys can be valid during rotation: create a new key, update your integration, then revoke the previous key. The API access and its webhooks are preserved.\n\n## Resources and IDs\n\n| Resource | Path | Meaning |\n|---|---|---|\n| Candidates | `/candidates` | Candidate profiles with contact details and custom fields |\n| Companies | `/companies` | Your customer companies in Mission Work |\n| Contacts | `/contacts` | Contacts associated with a customer company |\n| Jobs | `/jobs` | Your own jobs and available customer jobs |\n| Applications | `/hiring-process/applications` | A candidate’s application to a job and its hiring process |\n| Notes | `/notes` | Internal notes associated with records |\n| Tasks | `/tasks` | Manually created todos with a checklist |\n| Calls | `/calls` | Recorded calls |\n\nStore the returned IDs in your integration. These UUIDs link your records to Mission Work. `companyId` identifies a customer profile; `memberId` identifies a user within your organization, for example when assigning a task.\n\nEmail addresses and phone numbers are search filters. A search can return multiple candidates and does not automatically update or merge records. Use international phone numbers with a leading +, for example `+49301234567`.\n\n## Read and update fields\n\n`GET /record-schemas/{resourceType}` describes fields for candidates, companies or jobs: data types, required values, options and API support. Send custom values in `customFields` using each field’s ID as the key.\n\nA `PATCH` request changes only the fields you supply. Omitted fields remain unchanged. `null` clears a value where the field allows it. Pass the previously retrieved record revision as `expectedRevision`. On `409 revision_conflict`, retrieve the current record and review your update.\n\nWrites return a result containing the resource ID, resource URL and a revision where applicable. Retrieve the resource URL to read its current details.\n\nCandidate responses include `links.profileUpdate`. This link takes candidates to sign in and update their own profile.\n\n## Retry writes safely\n\nSend a UUID in the `Idempotency-Key` header for each new write operation. Retain this key until the outcome is known. Preview requests do not require an idempotency key.\n\nIf a response is lost or a temporary failure occurs, retry the same request with the same key. Mission Work does not execute an already committed operation again and returns its original result.\n\n| Response | Next step |\n|---|---|\n| `409 idempotency_conflict` | The key was used with different input. Check your operation. A genuinely new operation needs a new key. |\n| `409 request_in_progress` | The operation is still running. Wait for the indicated delay and retry the same request with the same key. |\n\nSuccessful operations are retained for retries for **30 days**. After that period, duplicate prevention is no longer guaranteed. For older operations, check the record using its stored Mission Work ID before starting a new operation.\n\n## Upload files\n\nUploads use `multipart/form-data` with exactly one file part named `file` and one text field named `metadata` containing a JSON object. Metadata includes the expected revision and, for document fields, the file’s target. The file must not exceed **10 MiB (10,485,760 bytes)**. Resumes support PDF, DOCX, TXT and Markdown. Each operation documents its metadata fields.\n\nUpload a profile resume with `PUT /candidates/{candidateId}/resume`. For other candidate documents, use a supported document field through `POST /candidates/{candidateId}/documents`. File processing can continue in the background after the upload has been accepted.\n\n## Manage applications and jobs\n\nAn application links an existing candidate to a job. Before creating it, call `POST /hiring-process/applications/preview` and review errors, warnings and required confirmations. Then submit the assignment with the reviewed input and any requested confirmation.\n\nFor later process steps, `GET /hiring-process/applications/{applicationId}/actions` lists the offered actions. Preview the selected action and execute it with the current stage revision. Actions can complete reviews, prepare an interview or withdraw an application. Requirements depend on your configured hiring process.\n\nEmployers see applications released to them. If a release is revoked, the application is no longer available to that access. Application read permission includes access to the current application resume; its metadata provides a `downloadUrl`.\n\nClose jobs through `/jobs/{jobId}/closure`. Retrieve its preview first and provide the required confirmation. You can create a note for additional remarks.\n\n## Lists and pagination\n\nPaginated resource lists return `items` and `nextCursor`. Use `limit` to choose a page size: the default is 50 and the maximum is 100. If `nextCursor` is set, pass it unchanged as `cursor` in the next request with the same filters. A `null` `nextCursor` means the list is complete.\n\n## Rate limits and errors\n\n| Limit | Requests per minute |\n|---|---|\n| Per API key | 120 |\n| Per organization, across all keys | 600 |\n| Per client IP | 600 |\n| Uploads per API key, in addition to the general limit | 10 |\n\nOn `429`, wait for the delay specified by the `Retry-After` header.\n\nError responses use `{ \"error\": { \"code\": \"…\", \"message\": \"…\" } }`. Use `error.code` for programmatic handling; `message` explains the error. Depending on the error, `error.details` provides further information. Include the `x-request-id` response header when contacting support.\n\n| Status | Meaning and next step |\n|---|---|\n| 400 | Invalid request or `cursor`. Check the parameters. |\n| 401 | Missing or invalid API key. Check the key. |\n| 403 | Required permission is missing. Check the API access role. |\n| 404 | Record does not exist or is unavailable to the access. |\n| 409 | Conflict, pending operation or required confirmation. Check the specific error code. |\n| 410 resync_required | Event `cursor` is no longer valid. Restart the full synchronization. |\n| 413 / 415 | File too large or unsupported type. Check upload requirements. |\n| 422 | Input could not be accepted. Review field details and correct the input. |\n| 500 / 503 | Server error or temporary unavailability. Retry; for writes, keep the same idempotency key. |\n\n## Set up webhooks\n\nOpen the API access in Mission Work and select **Add webhook** in its **Webhooks** section. Enter a name and a public HTTPS destination URL, then select the events you want to receive. The API access needs the corresponding read permissions.\n\nStore the signing secret shown after creation at your receiver. It verifies incoming webhooks and is separate from the API key used for REST requests. Use **Send test event** to check your setup.\n\nEach API access can have up to five webhooks, including paused webhooks.\n\n## Process events\n\nWebhooks contain an event ID, type, timestamps and a resource reference. Use `resource.url` to retrieve the current record. For example, `candidate.updated` indicates that a candidate has changed. Changes are reported whether they are made through the API or in Mission Work.\n\nEvents do not contain a copy of the record. It might have changed again by the time you retrieve it. `removed` means the record is no longer available to the API access, for example after erasure or revoked disclosure. Update your local records accordingly. `webhook.test` has no resource reference.\n\nYour receiver should:\n\n1. Verify the signature using the unaltered request bytes and the three `webhook-*` headers.\n2. Reject timestamps more than five minutes from its clock.\n3. Durably accept the event for processing and detect duplicates using `webhook-id`.\n4. Return `2xx` promptly and retrieve the record asynchronously.\n\nDeliveries can arrive more than once and out of order. Keep system clocks synchronized and use events as a signal to retrieve current state.\n\n## Verify signatures and rotate secrets\n\nSignatures follow the **Standard Webhooks** protocol:\n\n| Header | Content |\n|---|---|\n| `webhook-id` | Stable event ID, including retries |\n| `webhook-timestamp` | Unix timestamp in seconds, refreshed for each attempt |\n| `webhook-signature` | One or more space-separated signatures in the format `v1,` |\n\nThe signed bytes are the UTF-8 prefix `id.timestamp.` followed by the unaltered request body, signed with HMAC-SHA256. The secret starts with `whsec_`; the remainder is Base64-encoded. Prefer a Standard Webhooks library that handles signature comparison and timestamp validation. Do not modify or reserialize the body before verification.\n\nAfter rotation, the previous signing secret remains valid for another 24 hours. Both signatures are sent during this period. Update your receiver to the new secret and revoke the previous secret early if needed. You can rotate again after the overlap ends or the previous secret has been revoked.\n\n## Delivery and retries\n\nEach delivery attempt has a 15-second timeout. Mission Work retries network failures and responses with 408, 429 or 5xx. There are up to eight attempts over approximately 24 hours, with increasing delays. A valid `Retry-After` header is honored. Other 4xx responses end delivery; redirects are not followed.\n\nThe delivery history shows the latest status and lets you resend failed deliveries. The event ID stays the same.\n\nPausing stops new notifications and suppresses pending deliveries. Resuming delivers future events; skipped events are not replayed automatically. This also applies after deactivating and reactivating the API access. Use the events API to catch up or explicitly resend an eligible delivery.\n\n## Recover changes and synchronize records\n\nThe events API retains changes for **30 days**. Read `GET /events` with a stored `cursor`, or start with `since`, which refers to the event’s publication time. Retain `nextCursor` even if a response contains no visible events. Save it after processing the page. `hasMore: true` means you can retrieve the next page immediately. With `hasMore: false`, synchronization is currently up to date; use the saved cursor on your next poll.\n\nFor a full synchronization:\n\n1. Retrieve a starting `cursor` from `GET /events/checkpoint`.\n2. Read the required resource lists completely.\n3. Consume events from that `cursor` and save the new `cursor`.\n\nThis also captures changes made during the list scan. On `410 resync_required`, repeat this process. A `cursor` can become invalid after its retention period or after changes to the API access or its role. Rotating only an API key preserves it.\n\n## API version and reference\n\nPaths under `/v1` belong to API version 1. Field names, enum values and paths are identical in the German and English references. Download the OpenAPI document through OpenAPI JSON.\n\n## Example: candidate and resume\n\nYou need Node.js, curl, jq and an API access with candidate management permission. Save the JSON below as `candidate.json` and prepare `resume.pdf`. Adapt the candidate details, source and processing purpose to your use case.\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\nInspect errors, warnings and the returned confirmation. Set `CONFIRMED_PREVIEW_FINGERPRINT` to the returned fingerprint only after explicit approval. Do not create the application if the preview reports errors. Omit `confirmation` when none is required.\n\nFor later transitions, choose a currently available action from `GET .../actions`. Send `action`, `expectedStageRevision` and its typed `inputs` to `POST .../actions/preview`, then execute through `POST .../actions` with any required confirmation and a new idempotency key. Available actions depend on the current process stage.\n\n## Example: signature library\n\nInstall `standardwebhooks` in the receiver project. Put this fragment in your HTTP handler. `rawBody` contains the unchanged UTF-8 request bytes; `headers` contains the three `webhook-*` headers. Replace `queue.insertOnce` with your own durable processing and duplicate detection. Invalid signatures must produce an error response without enqueuing anything.\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\nBackground processing reads `new URL(event.resource.url, WORK_API_ORIGIN)` with the Bearer key for resource events. `webhook.test` needs no REST read. A `removed` event discards the local reference; GET may already return `404`. Respond successfully only after durable acceptance, without waiting for the REST read.\n" }, "servers": [ { "url": "/" } ], "paths": { "/v1/access-contexts/current": { "get": { "operationId": "getCurrentAccessContext", "summary": "Inspect the current API access", "description": "Returns the organization, API access and its current permissions. Use this endpoint to verify your key and assigned permissions.", "tags": [ "Access" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Current access context", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/candidates": { "get": { "operationId": "listCandidates", "summary": "List candidates", "description": "Lists candidates with cursor pagination. Search by name or filter by email address or phone number. Contact searches can return more than one match.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "post": { "operationId": "createCandidate", "summary": "Create candidate", "description": "Creates a candidate with contact details and optional custom fields. Use captureOrigin to describe the source and processing purpose. The response contains the new candidate ID, resource URL and revision.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read candidate", "description": "Returns current candidate details, custom fields and the revision to use for updates. links.profileUpdate opens the sign-in page for updating the profile.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "patch": { "operationId": "updateCandidate", "summary": "Update candidate", "description": "Updates the supplied candidate fields. Omitted fields remain unchanged; null clears a field where supported. Pass the last retrieved revision as 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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Preview candidate erasure", "description": "Previews the effects of erasing a candidate’s personal data. Review affected records and warnings before confirming erasure. This request does not change any data.", "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": "Current effects and confirmation", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Commit candidate erasure", "description": "Erases the candidate’s personal data using the required confirmation from the preview. If relevant data has changed, request a new preview.", "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": "Confirmed execution", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "List candidate documents", "description": "Lists documents your API access can read for this candidate, including metadata and the corresponding document field.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "post": { "operationId": "uploadCandidateDocument", "summary": "Upload candidate document", "description": "Uploads a file to a supported candidate document field. Send file and JSON metadata as multipart/form-data. The record schema describes the available document fields.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "413": { "description": "The upload exceeds its size limit (payload_too_large).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported file or content type (unsupported_media_type).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read document metadata", "description": "Returns metadata for a document assigned to the candidate. Use its content endpoint to download the file.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Download document", "description": "Downloads a file assigned to the candidate. The document ID must belong to the specified candidate.", "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": "Success", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Content is no longer available or synchronization must restart (resync_required).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read candidate resume", "description": "Returns metadata for the current profile resume. Returns 404 when no resume is stored. Retrieve the candidate to obtain the revision for an upload.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.candidates", "level": "view" } }, "put": { "operationId": "putCandidateResume", "summary": "Replace candidate resume", "description": "Uploads a new profile resume and replaces the previous assignment. Send the file and expectedRevision as multipart/form-data. Retrieve the revision from the candidate endpoint.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "413": { "description": "The upload exceeds its size limit (payload_too_large).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported file or content type (unsupported_media_type).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "List companies", "description": "Lists customer companies. Use query to search by name and nextCursor to retrieve more results.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.customers", "level": "view" } }, "post": { "operationId": "createCompany", "summary": "Create company", "description": "Creates a customer company with the supplied company details and custom fields. Your organization’s field configuration determines required fields.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read company", "description": "Returns a customer company’s current details, custom fields and revision for updates. companyId identifies the customer profile 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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.customers", "level": "view" } }, "patch": { "operationId": "updateCompany", "summary": "Update company", "description": "Updates the supplied company fields. Omitted fields remain unchanged. Pass the last retrieved revision as 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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "List contacts", "description": "Lists contacts available to your organization. Filter by companyId for a customer company or use query to search.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.contacts", "level": "view" } }, "post": { "operationId": "createContact", "summary": "Create contact", "description": "Creates a manual contact for the specified customer company. Use the customer profile ID as 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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read contact", "description": "Returns a contact’s details, company association and type. Shared contacts can belong to the connected organization.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.contacts", "level": "view" } }, "patch": { "operationId": "updateContact", "summary": "Update contact", "description": "Updates an editable manual contact using the supplied revision. Contacts linked to a user account are maintained through that account.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "List jobs", "description": "Lists available jobs. Use query to search by title or companyId to select jobs for a customer company.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "view" } }, "post": { "operationId": "createJob", "summary": "Create job", "description": "Creates a job for your own employer organization. Supply the title, number of openings and content languages. For a customer job, use 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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read job", "description": "Returns job details, content languages, customer association, current status and the revision for updates.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.jobs", "level": "view" } }, "patch": { "operationId": "updateJob", "summary": "Update job", "description": "Updates the supplied job fields using the last retrieved revision. Omitted fields remain unchanged. Use the closure endpoint to close a job.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Create a company job", "description": "Creates a job for the specified customer company. companyId identifies a customer profile for which your organization can manage jobs.", "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": "Success", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Preview job closure", "description": "Previews the effects of closing a job, including affected applications and required input. Review the preview before closing; this request does not change any data.", "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": "Current effects and confirmation", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Commit job closure", "description": "Closes the job using the required confirmation from the preview. A new preview is required if relevant data has changed.", "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": "Confirmed execution", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "List applications", "description": "Lists applications. Filter by candidate, job, status or process stage. Employers see applications released to them.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } }, "post": { "operationId": "createApplication", "summary": "Create an application", "description": "Assigns an existing candidate to a job and starts the selected process stage. Preview the assignment first and include any required confirmation.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Preview an assignment", "description": "Validates a proposed candidate-to-job assignment and returns errors, warnings and required confirmations. The preview does not create an application.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read an application", "description": "Returns an application’s status, current process stage and disclosure status. The stage revision is required for subsequent process actions.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Available actions", "description": "Returns the process actions currently offered and the corresponding stage revision. Preview an action to check its requirements and effects.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } }, "post": { "operationId": "executeApplicationAction", "summary": "Execute an action", "description": "Executes the selected process action with the validated input and expected stage revision. Include any confirmation required by the preview. On conflict, retrieve the current state and preview the action again.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Preview an action", "description": "Checks the selected action, input and expected stage revision. Returns requirements, warnings and any required confirmation without executing the action.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read the application resume", "description": "Returns the current application resume, download URL and revision. document is null when no resume is stored.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "recruiting.applications", "level": "view" } }, "put": { "operationId": "uploadApplicationResume", "summary": "Upload the application resume", "description": "Assigns an uploaded resume to the application. Send file and JSON metadata containing expectedRevision as multipart/form-data. alsoSetProfile can also assign the file as the profile resume where permitted.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "413": { "description": "The upload exceeds its size limit (payload_too_large).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported file or content type (unsupported_media_type).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Download the application resume", "description": "Downloads the application’s current resume. Application read permission and valid disclosure are sufficient; no additional candidate read permission is required.", "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": "Current application resume", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Content is no longer available or synchronization must restart (resync_required).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Adopt the profile resume", "description": "Assigns the existing profile resume to the application. Supply the current profile document ID and expectedRevision.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Select responsible people", "description": "Returns IDs and display names of active users in your organization, for example to assign a task. Requires read permission for at least one supported resource area.", "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": "Active people and next 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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/categories": { "get": { "operationId": "listCategories", "summary": "Select categories", "description": "Returns selectable categories and the default category for notes, tasks or calls. Specify the area you need; the API access must have its read permission.", "tags": [ "Reference data" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "resourceType", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "note", "task", "call" ] } } ], "responses": { "200": { "description": "Selectable categories", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/notes": { "get": { "operationId": "listNotes", "summary": "List notes", "description": "Lists readable internal notes with their content, category and available associations. Use nextCursor to retrieve more results.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.notes", "level": "view" } }, "post": { "operationId": "createNote", "summary": "Create note", "description": "Creates an internal note with HTML content and at least one association. Supported targets are candidates, jobs and customer companies. If categoryId is omitted, the default category is used.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Get note", "description": "Returns an internal note’s content, category and available associations. The API access must be able to read at least one associated record.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "List tasks", "description": "Lists manual todos with their checklist, assignee and due date. Automatically generated hiring-process tasks are not included.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-permission": { "key": "collaboration.inbox", "level": "view" } }, "post": { "operationId": "createTask", "summary": "Create task", "description": "Creates a manual todo with a category and at least one checklist item. You can optionally supply an assignee, due date, priority and associations.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Conflict: confirmation_required, revision_conflict, idempotency_conflict or request_in_progress. Review the preview and input; retry an in-progress request with the same idempotency key.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Get task", "description": "Returns a manual todo with its checklist, status, planning details and associations.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "List calls", "description": "Lists call records the API access can read, including direction, outcome, timestamps and available associations.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Get call", "description": "Returns details of a recorded call, including its outcome, notes and available associations.", "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": "Successful", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Read record schema", "description": "Describes fields for candidates, companies or jobs: types, required values, options and API support. Use field IDs to read or write custom values.", "tags": [ "record-schemas" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "resourceType", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "candidate", "company", "job" ] } } ], "responses": { "200": { "description": "Current field configuration", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/events": { "get": { "operationId": "listEvents", "summary": "Recover resource changes", "description": "Returns change events from the last 30 days. Start with since or a stored cursor and use nextCursor for the next request. A 410 resync_required response requires a full synchronization.", "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": "Events and next 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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Content is no longer available or synchronization must restart (resync_required).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/events/checkpoint": { "get": { "operationId": "getEventCheckpoint", "summary": "Prepare synchronization", "description": "Returns a starting cursor for a full synchronization. Retrieve it before reading resource lists, then consume changes from that cursor.", "tags": [ "Synchronization" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Bound starting cursor", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/v1/events/{eventId}": { "get": { "operationId": "getEvent", "summary": "Read an event", "description": "Returns an individual event notification within the 30-day retention period. Its resource URL refers to the current record. Unavailable events return 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": "Event reference", "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": "Malformed request or invalid cursor (bad_request).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Missing or invalid API key (unauthorized).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "The required permission is missing (forbidden).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "The resource is missing or inaccessible (not_found).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Invalid values (validation_failed); field information is available in error.details.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Request limit reached (rate_limited). Observe Retry-After.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Unexpected internal error (internal_error). Keep x-request-id for support.", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable (service_unavailable).", "headers": { "x-request-id": { "description": "Identifier for support requests", "schema": { "type": "string" } }, "Retry-After": { "description": "When present: seconds to wait before a technical retry", "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": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "candidate.updated": { "post": { "operationId": "receive_candidate_updated", "summary": "candidate.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "candidate.removed": { "post": { "operationId": "receive_candidate_removed", "summary": "candidate.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "company.created": { "post": { "operationId": "receive_company_created", "summary": "company.created", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "company.updated": { "post": { "operationId": "receive_company_updated", "summary": "company.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "company.removed": { "post": { "operationId": "receive_company_removed", "summary": "company.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "contact.created": { "post": { "operationId": "receive_contact_created", "summary": "contact.created", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "contact.updated": { "post": { "operationId": "receive_contact_updated", "summary": "contact.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "contact.removed": { "post": { "operationId": "receive_contact_removed", "summary": "contact.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "job.created": { "post": { "operationId": "receive_job_created", "summary": "job.created", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "job.updated": { "post": { "operationId": "receive_job_updated", "summary": "job.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "job.status_changed": { "post": { "operationId": "receive_job_status_changed", "summary": "job.status_changed", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "job.removed": { "post": { "operationId": "receive_job_removed", "summary": "job.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "hiring_process.application.created": { "post": { "operationId": "receive_hiring_process_application_created", "summary": "hiring_process.application.created", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "hiring_process.application.updated": { "post": { "operationId": "receive_hiring_process_application_updated", "summary": "hiring_process.application.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "hiring_process.application.stage_changed": { "post": { "operationId": "receive_hiring_process_application_stage_changed", "summary": "hiring_process.application.stage_changed", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "hiring_process.application.removed": { "post": { "operationId": "receive_hiring_process_application_removed", "summary": "hiring_process.application.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "note.created": { "post": { "operationId": "receive_note_created", "summary": "note.created", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "note.updated": { "post": { "operationId": "receive_note_updated", "summary": "note.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "note.removed": { "post": { "operationId": "receive_note_removed", "summary": "note.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "task.created": { "post": { "operationId": "receive_task_created", "summary": "task.created", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "task.updated": { "post": { "operationId": "receive_task_updated", "summary": "task.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "task.removed": { "post": { "operationId": "receive_task_removed", "summary": "task.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "call.recorded": { "post": { "operationId": "receive_call_recorded", "summary": "call.recorded", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "call.updated": { "post": { "operationId": "receive_call_updated", "summary": "call.updated", "description": "Retrieve resource.url to read the current record. The event does not contain a copy of the changed data; the record may have changed again since the event occurred. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "call.removed": { "post": { "operationId": "receive_call_removed", "summary": "call.removed", "description": "The resource is no longer available to this API access. Update your local records accordingly; its resource URL may already return 404. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } }, "webhook.test": { "post": { "operationId": "receive_webhook_test", "summary": "webhook.test", "description": "Tests your webhook receiver. This event has no resource reference and requires no API request. Verify the Standard Webhooks signature using the unaltered request bytes and a five-minute timestamp tolerance. Detect duplicates using webhook-id and return 2xx after durably accepting the event. Deliveries can arrive more than once and out of order.", "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 signature in the format v1,. Signed bytes: ... Multiple signatures can be present during secret rotation." } ], "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": "Durably accepted; no retry required" } } } } }, "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 } } } }