{"format":"jobhunt.support.operation/v1","revision":"f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f","contract_sha256":"acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e","documentation_only":true,"operation":{"name":"close_preparation_original_v1","description":"Explicitly close retry of one complete application PDF preparation original. Supply the captured account, exact original input and confirm_close=true. Uses the existing owner/receipt/job locks. An unused request is fenced; recorded means the same preparation was accepted, including pending, running or failed work, never proof that PDFs are ready. Verifies owned job type, receipt identity, application, fingerprint and selected document revisions using metadata only. No source content is read and no job, lease, queued authorization, PDF, document, application or stage is changed or cancelled. Expired/missing work is never recreated. Preserve the local original until exact closure is verified.","http":"POST /api/v1/journey/close_preparation_original_v1","readOnly":false,"scopes":["read:applications","read:documents","write:applications","write:documents"],"availability":"connected-journey","destructive":true,"implementation_sha256":"ccffef6885cc6c8f6c0a0490bc086d58ea6f5313d27cdf08bf6641e930d9a7c7","input_schema_ref":"/support/contracts.json#/tools/close_preparation_original_v1/inputSchema","output_schema_ref":"/support/contracts.json#/tools/close_preparation_original_v1/outputSchema","required_fields":["expected_account_id","original","confirm_close"]},"contract":{"annotations":{"destructiveHint":true,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Close preparation original request"},"description":"Explicitly close retry of one complete application PDF preparation original. Supply the captured account, exact original input and confirm_close=true. Uses the existing owner/receipt/job locks. An unused request is fenced; recorded means the same preparation was accepted, including pending, running or failed work, never proof that PDFs are ready. Verifies owned job type, receipt identity, application, fingerprint and selected document revisions using metadata only. No source content is read and no job, lease, queued authorization, PDF, document, application or stage is changed or cancelled. Expired/missing work is never recreated. Preserve the local original until exact closure is verified.","inputSchema":{"$defs":{"PreparationDocument":{"additionalProperties":false,"properties":{"document_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Document Id","type":"string"},"revision":{"maximum":2147483647,"minimum":1,"title":"Revision","type":"integer"}},"required":["document_id","revision"],"title":"PreparationDocument","type":"object"},"PreparePackage":{"additionalProperties":false,"properties":{"application_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Application Id","type":"string"},"documents":{"items":{"$ref":"#/$defs/PreparationDocument"},"maxItems":5,"minItems":1,"title":"Documents","type":"array"},"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"},"expected_revision":{"maximum":2147483647,"minimum":1,"title":"Expected Revision","type":"integer"},"fingerprint":{"pattern":"^[0-9a-f]{64}$","title":"Fingerprint","type":"string"},"request_id":{"maxLength":36,"minLength":36,"title":"Request Id","type":"string"},"workflow_revision":{"pattern":"^[0-9a-f]{64}$","title":"Workflow Revision","type":"string"}},"required":["request_id","application_id","expected_revision","workflow_revision","fingerprint","documents"],"title":"PreparePackage","type":"object"}},"additionalProperties":false,"properties":{"confirm_close":{"const":true,"title":"Confirm Close","type":"boolean"},"expected_account_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Expected Account Id","type":"string"},"original":{"$ref":"#/$defs/PreparePackage"}},"required":["expected_account_id","original","confirm_close"],"title":"ClosePreparationOriginal","type":"object"},"name":"close_preparation_original_v1","outputSchema":{"$defs":{"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"},"PreparationClosure":{"additionalProperties":false,"properties":{"application_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Application Id","type":"string"},"outcome":{"enum":["closed","recorded","expired"],"title":"Outcome","type":"string"},"payload_hash":{"pattern":"^[a-f0-9]{64}$","title":"Payload Hash","type":"string"},"recorded_resource_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"title":"Recorded Resource Id"},"request_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Request Id","type":"string"}},"required":["application_id","request_id","payload_hash","outcome","recorded_resource_id"],"title":"PreparationClosure","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/PreparationClosure"},{"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[PreparationClosure]","type":"object"},"title":"Close preparation original request"}}