{"format":"jobhunt.support.operation/v1","revision":"f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f","contract_sha256":"acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e","documentation_only":true,"operation":{"name":"change_search_routine","description":"Create, edit, delete or move a reviewed routine source or target; manage aggregator names or record a user-reported opened link. No URL is fetched or opened. Requires the full-state fingerprint and stable request_id; deletion requires explicit confirmation. Omitted fields remain; null clears optional URLs or aggregator.","http":"POST /api/v1/journey/change_search_routine","readOnly":false,"scopes":["read:profile","write:profile"],"availability":"connected-journey","destructive":true,"implementation_sha256":"489b4edb752b0c20974f5c0b7f7dea41a6af4bc12bfefa0cb31e9aaf43d1de07","input_schema_ref":"/support/contracts.json#/tools/change_search_routine/inputSchema","output_schema_ref":"/support/contracts.json#/tools/change_search_routine/outputSchema","required_fields":["request_id","expected_fingerprint","kind","action"]},"contract":{"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Change search routine"},"description":"Create, edit, delete or move a reviewed routine source or target; manage aggregator names or record a user-reported opened link. No URL is fetched or opened. Requires the full-state fingerprint and stable request_id; deletion requires explicit confirmation. Omitted fields remain; null clears optional URLs or aggregator.","inputSchema":{"$defs":{"SearchRoutineFields":{"additionalProperties":false,"properties":{"aggregator":{"anyOf":[{"maxLength":255,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Aggregator"},"careers_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"default":null,"title":"Careers Url"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Enabled"},"label":{"anyOf":[{"maxLength":255,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Label"},"name":{"anyOf":[{"maxLength":255,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Pinned"},"url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"title":"SearchRoutineFields","type":"object"}},"additionalProperties":false,"properties":{"action":{"enum":["create","update","delete","move","opened"],"title":"Action","type":"string"},"confirm_delete":{"anyOf":[{"const":true,"type":"boolean"},{"type":"null"}],"default":null,"title":"Confirm Delete"},"direction":{"anyOf":[{"enum":["up","down"],"type":"string"},{"type":"null"}],"default":null,"title":"Direction"},"entity_id":{"anyOf":[{"maxLength":255,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Entity Id"},"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_fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Expected Fingerprint","type":"string"},"fields":{"anyOf":[{"$ref":"#/$defs/SearchRoutineFields"},{"type":"null"}],"default":null},"kind":{"enum":["link","target","aggregator"],"title":"Kind","type":"string"},"request_id":{"maxLength":36,"minLength":36,"title":"Request Id","type":"string"}},"required":["request_id","expected_fingerprint","kind","action"],"title":"SearchRoutineWrite","type":"object"},"name":"change_search_routine","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"},"SearchRoutineAggregator":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"kind":{"const":"aggregator","title":"Kind","type":"string"},"name":{"title":"Name","type":"string"}},"required":["kind","id","name"],"title":"SearchRoutineAggregator","type":"object"},"SearchRoutineLink":{"additionalProperties":false,"properties":{"aggregator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aggregator"},"enabled":{"title":"Enabled","type":"boolean"},"id":{"title":"Id","type":"string"},"kind":{"const":"link","title":"Kind","type":"string"},"label":{"title":"Label","type":"string"},"last_opened":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Opened"},"order":{"title":"Order","type":"integer"},"url":{"title":"Url","type":"string"}},"required":["kind","id","label","url","aggregator","enabled","order","last_opened"],"title":"SearchRoutineLink","type":"object"},"SearchRoutineSaved":{"additionalProperties":false,"properties":{"deleted":{"title":"Deleted","type":"boolean"},"exists":{"title":"Exists","type":"boolean"},"fingerprint":{"pattern":"^[a-f0-9]{64}$","title":"Fingerprint","type":"string"},"id":{"title":"Id","type":"string"},"kind":{"enum":["link","target","aggregator"],"title":"Kind","type":"string"},"record":{"anyOf":[{"discriminator":{"mapping":{"aggregator":"#/$defs/SearchRoutineAggregator","link":"#/$defs/SearchRoutineLink","target":"#/$defs/SearchRoutineTarget"},"propertyName":"kind"},"oneOf":[{"$ref":"#/$defs/SearchRoutineLink"},{"$ref":"#/$defs/SearchRoutineTarget"},{"$ref":"#/$defs/SearchRoutineAggregator"}]},{"type":"null"}],"title":"Record"}},"required":["id","kind","deleted","exists","fingerprint","record"],"title":"SearchRoutineSaved","type":"object"},"SearchRoutineTarget":{"additionalProperties":false,"properties":{"careers_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Careers Url"},"id":{"title":"Id","type":"string"},"kind":{"const":"target","title":"Kind","type":"string"},"name":{"title":"Name","type":"string"},"order":{"title":"Order","type":"integer"},"pinned":{"title":"Pinned","type":"boolean"}},"required":["kind","id","name","careers_url","pinned","order"],"title":"SearchRoutineTarget","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/SearchRoutineSaved"},{"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[SearchRoutineSaved]","type":"object"},"title":"Change search routine"}}