Challenges

Challenge status

updateset_challenge_status

Changes a challenge's status to active, paused, completed or abandoned, at the user's request. Pausing or ending it also cancels active challenge check-in reminders. Completing or abandoning it also ends membership in its challenge crew, when present.

Access: Changes records the person already has.
Annotations: readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: falsetitle: Pause, resume, finish or abandon a challenge
Time limit: 25 seconds, then the call stops with an error.

updateset_challenge_status

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "set_challenge_status",    "arguments": {      "challengeId": "28b1efff-4c4a-4c3a-8eb9-da51c6d902d8",      "status": "paused"    }  }}

Result

{  "ok": true,  "challengeId": "28b1efff-4c4a-4c3a-8eb9-da51c6d902d8",  "name": "<stored_data>7-Day Hydration Challenge</stored_data>",  "status": "paused"}

Parameters

challengeIdstring (uuid)Required
statusstringRequired
One of active, paused, completed, abandoned

Result

One text item holding a JSON object, as in the example.

Pausing, completing or abandoning a challenge cancels its active goal check-in reminders. Completing or abandoning also removes the person from the challenge's crew.

Errors

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.