/i/tasks/update

Endpoint

/i/tasks/update

Overview

Requests a rerun of an existing task by ID.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• Requires write access to feature core for the target app.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or use auth_token)	Dashboard API authentication key.
auth_token	String	Yes (or use api_key)	Dashboard auth token.
app_id	String	Yes	App ID used for write-permission validation.
task_id	String	Yes	Task ID to rerun.

Examples

Example 1: Rerun task

/i/tasks/update?
  api_key=YOUR_API_KEY&
  app_id=6991c75b024cb89cdc04efd2&
  task_id=17f0f6c3a2c42cbced96d4a01f88f9a7f45bc7a5

Response

Success Response

Rerun accepted:

{
  "result": "Success"
}

Task cannot be rerun:

{
  "result": "This task cannot be run again"
}

No runnable auth context:

{
  "result": "No permission to run this task"
}

Response Fields

Field	Type	Description
result	String	Rerun outcome message from task manager.

Error Responses

Status Code: 400 Bad Request

{
  "result": "Missing parameter \"task_id\""
}

Behavior

Behavior Modes

Mode	Trigger	Processing Path	Response Shape
Rerun mode	Task has stored replayable request payload	Marks task as rerunning and replays request.	Wrapped string { "result": "Success" }
Non-rerunnable mode	Task missing replayable request or task not found	Returns informational no-rerun message.	Wrapped string { "result": "This task cannot be run again" }
Permission fallback mode	Replay request has no usable API key context	Returns permission message from rerun flow.	Wrapped string { "result": "No permission to run this task" }

Impact on Other Data

• Updates task state and may produce new task result output.

Operational Considerations

• Rerun starts asynchronous processing; result message is immediate and not final completion status.

Limitations

• Endpoint does not return final task output; check task endpoints for completion state and data.

Related Endpoints

• Tasks - Check Task Status
• Tasks - Read Task
• Tasks - Delete Task

Implementation details

Audit & System Logs

• No direct /systemlogs action is emitted by this endpoint.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.members	Replay permission context resolution	Reads member/global-admin API key fallback when rerunning stored requests.
countly.long_tasks	Task status and request replay source	Reads task definition and updates run status.
countly_fs.task_results	Task output storage	May be updated when rerun completes with new result data.