{"format":"jobhunt.support.operation/v1","revision":"f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f","contract_sha256":"acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e","documentation_only":true,"operation":{"name":"review_calendar_handoff","description":"Explicitly review current saved source/settings for a failed, definitely unadmitted Calendar handoff. Pass its current fingerprint. May inspect the captured event but saves nothing. No review is offered while a worker runs, an original child exists or admission is unconfirmed. Review expires in 15 minutes; resume only that exact proof.","http":"GET /api/v1/journey/review_calendar_handoff","readOnly":true,"scopes":["read:calendar"],"availability":"connected-journey","destructive":false,"implementation_sha256":"6c4f28bffdf9737722c52a7aa5e0f123af5ab0f1dbc0952bf8419f63fb2dd304","input_schema_ref":"/support/contracts.json#/tools/review_calendar_handoff/inputSchema","output_schema_ref":"/support/contracts.json#/tools/review_calendar_handoff/outputSchema","required_fields":["handoff_id","expected_fingerprint"]},"contract":{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true,"title":"Review calendar handoff"},"description":"Explicitly review current saved source/settings for a failed, definitely unadmitted Calendar handoff. Pass its current fingerprint. May inspect the captured event but saves nothing. No review is offered while a worker runs, an original child exists or admission is unconfirmed. Review expires in 15 minutes; resume only that exact proof.","inputSchema":{"additionalProperties":false,"properties":{"expected_fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Expected Fingerprint","type":"string"},"handoff_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Handoff Id","type":"string"}},"required":["handoff_id","expected_fingerprint"],"title":"HandoffReviewInput","type":"object"},"name":"review_calendar_handoff","outputSchema":{"$defs":{"CalendarReview":{"additionalProperties":false,"properties":{"calendar_id":{"maxLength":1024,"minLength":1,"title":"Calendar Id","type":"string"},"event_fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Event Fingerprint","type":"string"},"event_id":{"anyOf":[{"maxLength":1024,"minLength":1,"type":"string"},{"type":"null"}],"title":"Event Id"},"fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Fingerprint","type":"string"},"mode":{"enum":["create","update","remove"],"title":"Mode","type":"string"},"previous_event_retained":{"title":"Previous Event Retained","type":"boolean"},"review_token":{"maxLength":8192,"minLength":1,"title":"Review Token","type":"string"},"selection":{"$ref":"#/$defs/CalendarSelection"},"source_fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Source Fingerprint","type":"string"},"status_prefix":{"enum":["","Done","Skipped"],"title":"Status Prefix","type":"string"}},"required":["selection","mode","calendar_id","event_id","source_fingerprint","event_fingerprint","fingerprint","review_token","status_prefix","previous_event_retained"],"title":"CalendarReview","type":"object"},"CalendarSelection":{"additionalProperties":false,"properties":{"action":{"default":"sync","enum":["sync","status","remove"],"title":"Action","type":"string"},"connection_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Connection Id","type":"string"},"recover_of":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Recover Of"},"source_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Source Id","type":"string"},"source_kind":{"enum":["interview","task"],"title":"Source Kind","type":"string"}},"required":["connection_id","source_kind","source_id"],"title":"CalendarSelection","type":"object"},"Failure":{"additionalProperties":false,"properties":{"code":{"enum":["authentication_required","account_changed","insufficient_scope","access_unavailable","not_found","invalid_input","revision_conflict","request_id_conflict","source_unavailable","processing_failed","rate_limited","retry_expired"],"title":"Code","type":"string"},"message":{"maxLength":1000,"minLength":1,"title":"Message","type":"string"},"retry_after_seconds":{"anyOf":[{"maximum":900,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Retry After Seconds"}},"required":["code","message"],"title":"Failure","type":"object"},"HandoffReview":{"additionalProperties":false,"properties":{"handoff":{"$ref":"#/$defs/HandoffState"},"review":{"$ref":"#/$defs/CalendarReview"}},"required":["handoff","review"],"title":"HandoffReview","type":"object"},"HandoffState":{"additionalProperties":false,"properties":{"admission":{"enum":["not_admitted","confirmed","unconfirmed"],"title":"Admission","type":"string"},"can_resolve":{"title":"Can Resolve","type":"boolean"},"can_review":{"title":"Can Review","type":"boolean"},"change_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"title":"Change Id"},"failure_code":{"anyOf":[{"enum":["source_or_access_changed","handoff_unavailable","receipt_conflict"],"type":"string"},{"type":"null"}],"title":"Failure Code"},"fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Fingerprint","type":"string"},"id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Id","type":"string"},"selection":{"$ref":"#/$defs/CalendarSelection"},"status":{"enum":["pending","running","failed","queued","resolved","needs_review"],"title":"Status","type":"string"}},"required":["id","selection","status","admission","change_id","failure_code","can_review","can_resolve","fingerprint"],"title":"HandoffState","type":"object"},"NextAction":{"additionalProperties":false,"properties":{"kind":{"enum":["read","edit","select","retry","reconnect","consent","open_website","open_employer","support","none"],"title":"Kind","type":"string"},"label":{"maxLength":255,"title":"Label","type":"string"},"record_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Record Id"}},"required":["kind","label"],"title":"NextAction","type":"object"},"Operation":{"additionalProperties":false,"properties":{"error":{"anyOf":[{"$ref":"#/$defs/Failure"},{"type":"null"}],"default":null},"id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Id","type":"string"},"kind":{"maxLength":100,"minLength":1,"title":"Kind","type":"string"},"resource":{"anyOf":[{"$ref":"#/$defs/Summary"},{"type":"null"}],"default":null},"retry_after_seconds":{"maximum":900,"minimum":0,"title":"Retry After Seconds","type":"integer"},"retry_expires_at":{"maxLength":40,"minLength":20,"title":"Retry Expires At","type":"string"},"status":{"enum":["pending","running","succeeded","failed"],"title":"Status","type":"string"}},"required":["id","status","kind","retry_after_seconds","retry_expires_at"],"title":"Operation","type":"object"},"Summary":{"additionalProperties":false,"properties":{"id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Id","type":"string"},"kind":{"enum":["application","search","document","task","interview","contact","company","note","profile","package","notification","highlight"],"title":"Kind","type":"string"},"label":{"maxLength":255,"minLength":1,"title":"Label","type":"string"},"revision":{"anyOf":[{"maximum":2147483647,"minimum":1,"type":"integer"},{"type":"null"}],"title":"Revision"},"website_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"default":null,"title":"Website Url"}},"required":["id","kind","label","revision"],"title":"Summary","type":"object"}},"additionalProperties":false,"properties":{"data":{"anyOf":[{"$ref":"#/$defs/HandoffReview"},{"type":"null"}]},"error":{"anyOf":[{"$ref":"#/$defs/Failure"},{"type":"null"}],"default":null},"next_action":{"$ref":"#/$defs/NextAction"},"operation":{"anyOf":[{"$ref":"#/$defs/Operation"},{"type":"null"}],"default":null},"outcome":{"enum":["ready","pending","needs_input","conflict","failed"],"title":"Outcome","type":"string"},"revision":{"anyOf":[{"maximum":2147483647,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Revision"},"website_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"default":null,"title":"Website Url"}},"required":["outcome","data","next_action"],"title":"Result[HandoffReview]","type":"object"},"title":"Review calendar handoff"}}