{"format":"jobhunt.support.operation/v1","revision":"f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f","contract_sha256":"acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e","documentation_only":true,"operation":{"name":"queue_calendar_changes","description":"Register one original batch request and queue up to 20 distinct signed calendar reviews through the individual authorized queue service. Each accepted item has its own durable job, request ID and receipt; failures are explicit per item, as with native partial sync-all. Registration is not provider delivery or an all-or-nothing transaction. No provider IO occurs here. After interruption retry the exact original batch request ID and ordered review_tokens; accepted items are never queued again. Unqueued expired/stale reviews need fresh individual review and a new batch containing only rejected items. Read each change for provider/local outcomes; traverse all upcoming-source pages for complete sync-all coverage.","http":"POST /api/v1/journey/queue_calendar_changes","readOnly":false,"scopes":["write:calendar"],"availability":"connected-journey","destructive":true,"implementation_sha256":"fa33a6f641a5f22214afde0a7d96346b3050b499a83d4899780c42df2d3c6215","input_schema_ref":"/support/contracts.json#/tools/queue_calendar_changes/inputSchema","output_schema_ref":"/support/contracts.json#/tools/queue_calendar_changes/outputSchema","required_fields":["request_id","review_tokens"]},"contract":{"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Queue calendar changes"},"description":"Register one original batch request and queue up to 20 distinct signed calendar reviews through the individual authorized queue service. Each accepted item has its own durable job, request ID and receipt; failures are explicit per item, as with native partial sync-all. Registration is not provider delivery or an all-or-nothing transaction. No provider IO occurs here. After interruption retry the exact original batch request ID and ordered review_tokens; accepted items are never queued again. Unqueued expired/stale reviews need fresh individual review and a new batch containing only rejected items. Read each change for provider/local outcomes; traverse all upcoming-source pages for complete sync-all coverage.","inputSchema":{"additionalProperties":false,"properties":{"expected_account_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"description":"Use the verified get_connected_account ID for this intent. A changed connection is rejected before any action; never replace it automatically on retry.","title":"Expected Account Id"},"request_id":{"maxLength":36,"minLength":36,"title":"Request Id","type":"string"},"review_tokens":{"items":{"maxLength":8192,"minLength":1,"type":"string"},"maxItems":20,"minItems":1,"title":"Review Tokens","type":"array"}},"required":["request_id","review_tokens"],"title":"BatchQueue","type":"object"},"name":"queue_calendar_changes","outputSchema":{"$defs":{"BatchItem":{"additionalProperties":false,"properties":{"change":{"anyOf":[{"$ref":"#/$defs/CalendarChangeState"},{"type":"null"}]},"error":{"anyOf":[{"$ref":"#/$defs/Failure"},{"type":"null"}]},"request_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Request Id","type":"string"}},"required":["request_id","change","error"],"title":"BatchItem","type":"object"},"BatchQueued":{"additionalProperties":false,"properties":{"accepted":{"title":"Accepted","type":"integer"},"batch_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Batch Id","type":"string"},"items":{"items":{"$ref":"#/$defs/BatchItem"},"maxItems":20,"minItems":1,"title":"Items","type":"array"},"rejected":{"title":"Rejected","type":"integer"}},"required":["batch_id","items","accepted","rejected"],"title":"BatchQueued","type":"object"},"CalendarChangeState":{"additionalProperties":false,"properties":{"calendar_id":{"maxLength":1024,"minLength":1,"title":"Calendar Id","type":"string"},"can_cancel":{"title":"Can Cancel","type":"boolean"},"event_id":{"maxLength":1024,"minLength":1,"title":"Event Id","type":"string"},"failure_code":{"anyOf":[{"maxLength":64,"minLength":1,"pattern":"^[a-z][a-z0-9._-]*$","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"},"local_state":{"enum":["pending","applied","unchanged","needs_review"],"title":"Local State","type":"string"},"mode":{"enum":["create","update","remove"],"title":"Mode","type":"string"},"provider_state":{"enum":["not_started","unknown","confirmed","refused"],"title":"Provider State","type":"string"},"resolution":{"anyOf":[{"enum":["followup","left_unchanged"],"type":"string"},{"type":"null"}],"title":"Resolution"},"resolved_by":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"title":"Resolved By"},"selection":{"$ref":"#/$defs/CalendarSelection"},"status":{"enum":["pending","running","succeeded","failed","cancelled","needs_review","resolved"],"title":"Status","type":"string"}},"required":["id","selection","mode","calendar_id","event_id","status","provider_state","local_state","failure_code","can_cancel","resolved_by","resolution","fingerprint"],"title":"CalendarChangeState","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"},"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/BatchQueued"},{"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[BatchQueued]","type":"object"},"title":"Queue calendar changes"}}