{"format":"jobhunt.support.operation/v1","revision":"f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f","contract_sha256":"acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e","documentation_only":true,"operation":{"name":"record_submission","description":"Record an application only after the user explicitly says they submitted it. user_confirmed must be true. This is a user_report, never employer-verified evidence. Record the actual date and optional public HTTPS destination. Select the exact prepared package or owned application attachments they used; if unknown, document_knowledge=unknown with no file references. Never infer the newest file. The report and optional move to Applied are atomic; later stages stay in place. Set move_to_applied=false to keep the current stage. Corrections append a new report using supersedes_id. Reuse request_id after interruption. No employer send or billing action occurs.","http":"POST /api/v1/journey/record_submission","readOnly":false,"scopes":["write:applications"],"availability":"connected-journey","destructive":true,"implementation_sha256":"b7cb0110eeec5b43f3044c1c2a47353368e6ed39fa430a4bc8fe550e8854386e","input_schema_ref":"/support/contracts.json#/tools/record_submission/inputSchema","output_schema_ref":"/support/contracts.json#/tools/record_submission/outputSchema","required_fields":["request_id","application_id","expected_revision","date","user_confirmed","document_knowledge"]},"contract":{"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Record submission"},"description":"Record an application only after the user explicitly says they submitted it. user_confirmed must be true. This is a user_report, never employer-verified evidence. Record the actual date and optional public HTTPS destination. Select the exact prepared package or owned application attachments they used; if unknown, document_knowledge=unknown with no file references. Never infer the newest file. The report and optional move to Applied are atomic; later stages stay in place. Set move_to_applied=false to keep the current stage. Corrections append a new report using supersedes_id. Reuse request_id after interruption. No employer send or billing action occurs.","inputSchema":{"additionalProperties":false,"oneOf":[{"not":{"required":["external_document_ids"]},"properties":{"document_knowledge":{"const":"prepared"},"prepared_id":{"type":"string"}},"required":["prepared_id"]},{"not":{"required":["prepared_id"]},"properties":{"document_knowledge":{"const":"external"},"external_document_ids":{"type":"array"}},"required":["external_document_ids"]},{"not":{"anyOf":[{"required":["prepared_id"]},{"required":["external_document_ids"]}]},"properties":{"document_knowledge":{"const":"unknown"}}}],"properties":{"application_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Application Id","type":"string"},"date":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date","type":"string"},"destination":{"anyOf":[{"maxLength":2048,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Destination"},"document_knowledge":{"enum":["prepared","external","unknown"],"title":"Document Knowledge","type":"string"},"evidence":{"const":"user_report","default":"user_report","title":"Evidence","type":"string"},"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"},"external_document_ids":{"anyOf":[{"items":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},"maxItems":5,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"External Document Ids"},"move_to_applied":{"default":true,"title":"Move To Applied","type":"boolean"},"prepared_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Prepared Id"},"request_id":{"maxLength":36,"minLength":36,"title":"Request Id","type":"string"},"supersedes_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Supersedes Id"},"user_confirmed":{"const":true,"title":"User Confirmed","type":"boolean"}},"required":["request_id","application_id","expected_revision","date","user_confirmed","document_knowledge"],"title":"RecordSubmission","type":"object"},"name":"record_submission","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"},"Submission":{"additionalProperties":false,"properties":{"application_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Application Id","type":"string"},"date":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date","type":"string"},"destination":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"default":null,"title":"Destination"},"destination_known":{"title":"Destination Known","type":"boolean"},"document_knowledge":{"enum":["prepared","external","unknown"],"title":"Document Knowledge","type":"string"},"documents":{"items":{"$ref":"#/$defs/SubmissionFile"},"maxItems":5,"title":"Documents","type":"array"},"evidence":{"const":"user_report","title":"Evidence","type":"string"},"id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Id","type":"string"},"prepared_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Prepared Id"},"recorded_at":{"maxLength":40,"title":"Recorded At","type":"string"},"superseded":{"title":"Superseded","type":"boolean"},"supersedes_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Supersedes Id"}},"required":["id","application_id","date","evidence","document_knowledge","documents","destination_known","superseded","recorded_at"],"title":"Submission","type":"object"},"SubmissionFile":{"additionalProperties":false,"properties":{"id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Id","type":"string"},"kind":{"enum":["prepared","external"],"title":"Kind","type":"string"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"sha256":{"anyOf":[{"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Sha256"},"type":{"maxLength":40,"title":"Type","type":"string"}},"required":["id","name","kind","type"],"title":"SubmissionFile","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/Submission"},{"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[Submission]","type":"object"},"title":"Record submission"}}