{"format":"jobhunt.support.operation/v1","revision":"f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f","contract_sha256":"acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e","documentation_only":true,"operation":{"name":"create_task_v2","description":"Create one requested follow-up, standalone or linked to an owned application/search. Reuse request_id after a lost response and check get_job_hunt_operation. Calendar dates stay on their supplied day; timed due_at values require a timezone. Use recurrence for explicit repeating requests; weekly/custom_days use Monday=0 through Sunday=6, and optional due_time uses the account timezone. Do not invent a time or turn a recurring request into a one-off. Linking a job/search also requires its read grant. Records a task only: no email, invitation, calendar sync or scheduled outreach.","http":"POST /api/v1/journey/create_task_v2","readOnly":false,"scopes":["write:tasks"],"availability":"connected-journey","destructive":true,"implementation_sha256":"954c0653172a5239aab223f68cb7b2bc5014b99e3697a553857ba0b147417622","input_schema_ref":"/support/contracts.json#/tools/create_task_v2/inputSchema","output_schema_ref":"/support/contracts.json#/tools/create_task_v2/outputSchema","required_fields":["title","request_id"]},"contract":{"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Create task"},"description":"Create one requested follow-up, standalone or linked to an owned application/search. Reuse request_id after a lost response and check get_job_hunt_operation. Calendar dates stay on their supplied day; timed due_at values require a timezone. Use recurrence for explicit repeating requests; weekly/custom_days use Monday=0 through Sunday=6, and optional due_time uses the account timezone. Do not invent a time or turn a recurring request into a one-off. Linking a job/search also requires its read grant. Records a task only: no email, invitation, calendar sync or scheduled outreach.","inputSchema":{"$defs":{"TaskSchedule":{"additionalProperties":false,"properties":{"days":{"default":[],"items":{"maximum":6,"minimum":0,"type":"integer"},"maxItems":7,"title":"Days","type":"array"},"due_time":{"anyOf":[{"pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","type":"string"},{"type":"null"}],"default":null,"title":"Due Time"},"paused":{"default":false,"title":"Paused","type":"boolean"},"times_per_week":{"anyOf":[{"maximum":7,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Times Per Week"},"type":{"enum":["daily","weekdays","mwf","tth","weekly","custom_days","times_per_week"],"title":"Type","type":"string"}},"required":["type"],"title":"TaskSchedule","type":"object"}},"additionalProperties":false,"properties":{"application_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Application Id"},"description":{"anyOf":[{"maxLength":12000,"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"due_at":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"title":"Due At"},"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"},"recurrence":{"anyOf":[{"$ref":"#/$defs/TaskSchedule"},{"type":"null"}],"default":null},"request_id":{"maxLength":36,"minLength":36,"title":"Request Id","type":"string"},"search_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"default":null,"title":"Search Id"},"title":{"maxLength":255,"minLength":1,"title":"Title","type":"string"}},"required":["title","request_id"],"title":"TaskCreate","type":"object"},"name":"create_task_v2","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"},"Occurrence":{"additionalProperties":false,"properties":{"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"date":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date","type":"string"},"days":{"items":{"type":"integer"},"title":"Days","type":"array"},"due_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Due Time"},"fingerprint":{"title":"Fingerprint","type":"string"},"paused":{"title":"Paused","type":"boolean"},"status":{"default":"open","enum":["open","completed","skipped","unknown"],"title":"Status","type":"string"},"times_per_week":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Times Per Week"},"type":{"title":"Type","type":"string"}},"required":["type","days","times_per_week","paused","date","completed_at","fingerprint"],"title":"Occurrence","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"},"SavedTask":{"additionalProperties":false,"properties":{"application_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"title":"Application Id"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"description_truncated":{"title":"Description Truncated","type":"boolean"},"due_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due At"},"id":{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Id","type":"string"},"is_active":{"title":"Is Active","type":"boolean"},"recurrence":{"anyOf":[{"$ref":"#/$defs/Occurrence"},{"type":"null"}],"default":null},"revision":{"maximum":2147483647,"minimum":1,"title":"Revision","type":"integer"},"search_id":{"anyOf":[{"maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"title":"Search Id"},"title":{"title":"Title","type":"string"}},"required":["id","revision","title","description","description_truncated","due_at","is_active","completed_at","application_id","search_id"],"title":"SavedTask","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/SavedTask"},{"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[SavedTask]","type":"object"},"title":"Create task"}}