Challenges
createcreate_challenge
Creates a challenge with daily tasks from an available template or a custom plan. confirmedByUser records the user's approval of its name, start date, duration and tasks. An unconfirmed request does not create a challenge.
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: falsetitle: Start a challengeconfirmedByUserbooleanRequiredtrue when the user asked to start this challenge (a named preset or a complete plan) or approved your drafted plan. false while you are only proposing a draft.
namestringRequired2 to 80 characters
descriptionstringUp to 300 characters
durationDaysintegerRequired for custom challenges; omit with templateId to use the preset's length.
1 to 365
startDatestringRequiredChallenge start date as YYYY-MM-DD in the user's timezone.
Format YYYY-MM-DD
templateIdstringPreset id when the user asked for a known program.
One of 75-hard, 30-day-fitness, 21-day-mindfulness
tasksarray of stringsBinary daily tasks in display order. Omit together with templateId to use the preset list verbatim.
1 to 12 items
One text item holding a JSON object, as in the example.
templateId fills the length and tasks; pass tasks only to change them. Every task is one yes-or-no action for each day.This tool's own errors, each returned with isError: true:
durationDays and a tasks list (or pass a preset templateId).Every tool returns isError with a message when its arguments don't match the schema, a limit is reached, the person turned the agent off, or iAM360 has a problem. See Errors and limits.