{"format":"jobhunt.support.operation/v1","revision":"f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f","contract_sha256":"acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e","documentation_only":true,"operation":{"name":"save_highlight_fields_file","description":"Create or partially update one owned Highlight from an explicitly selected UTF-8 JSON fields object up to 16 MiB on an approved private host. Preserves all native text/tags and omission/null semantics. Supply verified account, exact source size/SHA-256, original request ID, and for edits the reviewed Highlight ID/fingerprint. Uses save_workspace_highlight_v2 original receipts, including the native first-capture task grant. Related company/Hunt fields require their existing grants. Retry keeps the entire original fields/account/key; read the original operation receipt without downloading the file to check an interrupted save. Does not publish or send anything.","http":"POST /api/v1/journey/save_highlight_fields_file","readOnly":false,"scopes":["read:highlights","write:highlights"],"availability":"connected-journey","destructive":true,"implementation_sha256":"3cd7f20982517911fce4a8fced6cb968eea458b62375bcacde31dff9459e9fda","input_schema_ref":"/support/contracts.json#/tools/save_highlight_fields_file/inputSchema","output_schema_ref":"/support/contracts.json#/tools/save_highlight_fields_file/outputSchema","required_fields":["expected_account_id","request_id","action","source_sha256","source_size","file"]},"contract":{"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Save highlight fields file"},"description":"Create or partially update one owned Highlight from an explicitly selected UTF-8 JSON fields object up to 16 MiB on an approved private host. Preserves all native text/tags and omission/null semantics. Supply verified account, exact source size/SHA-256, original request ID, and for edits the reviewed Highlight ID/fingerprint. Uses save_workspace_highlight_v2 original receipts, including the native first-capture task grant. Related company/Hunt fields require their existing grants. Retry keeps the entire original fields/account/key; read the original operation receipt without downloading the file to check an interrupted save. Does not publish or send anything.","inputSchema":{"$defs":{"HostFile":{"additionalProperties":false,"properties":{"download_url":{"maxLength":2048,"minLength":1,"title":"Download Url","type":"string"},"file_id":{"maxLength":256,"minLength":1,"title":"File Id","type":"string"},"file_name":{"default":"","maxLength":255,"title":"File Name","type":"string"},"mime_type":{"default":"","maxLength":255,"title":"Mime Type","type":"string"}},"required":["download_url","file_id"],"title":"HostFile","type":"object"}},"additionalProperties":false,"properties":{"action":{"enum":["create","update"],"title":"Action","type":"string"},"expected_account_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Expected Account Id","type":"string"},"expected_fingerprint":{"anyOf":[{"pattern":"^[a-f0-9]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Expected Fingerprint"},"file":{"$ref":"#/$defs/HostFile"},"highlight_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Highlight Id"},"request_id":{"maxLength":36,"minLength":36,"title":"Request Id","type":"string"},"source_sha256":{"pattern":"^[a-f0-9]{64}$","title":"Source Sha256","type":"string"},"source_size":{"maximum":16777216,"minimum":1,"title":"Source Size","type":"integer"}},"required":["expected_account_id","request_id","action","source_sha256","source_size","file"],"title":"HighlightHostFile","type":"object"},"name":"save_highlight_fields_file","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"},"HighlightFileManifest":{"additionalProperties":false,"properties":{"account_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Account Id","type":"string"},"chunk_bytes":{"const":24000,"default":24000,"title":"Chunk Bytes","type":"integer"},"chunk_count":{"minimum":1,"title":"Chunk Count","type":"integer"},"date":{"title":"Date","type":"string"},"filename":{"title":"Filename","type":"string"},"fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Fingerprint","type":"string"},"format":{"const":"jobhunt.highlight-record/v1","default":"jobhunt.highlight-record/v1","title":"Format","type":"string"},"highlight_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Highlight Id","type":"string"},"mime":{"const":"application/json","default":"application/json","title":"Mime","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","title":"Sha256","type":"string"},"size_bytes":{"minimum":1,"title":"Size Bytes","type":"integer"},"title":{"maxLength":500,"title":"Title","type":"string"}},"required":["account_id","highlight_id","fingerprint","title","date","filename","size_bytes","chunk_count","sha256"],"title":"HighlightFileManifest","type":"object"},"HighlightFileSaved":{"additionalProperties":false,"properties":{"current":{"anyOf":[{"$ref":"#/$defs/HighlightFileManifest"},{"type":"null"}]},"highlight_id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Highlight Id","type":"string"}},"required":["highlight_id","current"],"title":"HighlightFileSaved","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/HighlightFileSaved"},{"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[HighlightFileSaved]","type":"object"},"title":"Save highlight fields file"}}