External work management

15 min

external_sub_step_started

An external substep was started from a task.

Payload

Key	Type	Description
event_name	string	Name of the event. The value is external_sub_step_started.
data	object	Data of the event.
data[task]	object	Data of the task associated with the external substep.
data[task][id]	string	Unique identifier of the task.
data[task][links]	object	Links related to the task.
data[task][links][self]	string	URL to fetch the task through the CMP Open API.
data[task][links][assets]	string	URL to fetch the assets associated with the task through the CMP Open API.
data[step]	object	Data of the step associated with the external substep.
data[step][id]	string	Unique identifier of the step.
data[step][links]	object	Links related to the step.
data[step][links][task]	string	URL to fetch the task associated with the step through the CMP Open API.
data[sub_step]	object	Data of the substep associated with the external substep.
data[sub_step][id]	string	Unique identifier of the substep.
data[sub_step][links]	object	Links related to the substep.
data[sub_step][links][self]	string	URL to fetch the substep through the CMP Open API.
data[sub_step][links][task]	string	URL to fetch the task associated with the substep through the CMP Open API.
data[sub_step][links][external_work]	string	URL to fetch the external work associated with the substep through the CMP Open API.
data[external_work]	object	Data of the external work associated with the external substep.
data[external_work][external_system]	string	Name of the external system associated with the external work.
data[external_work][links]	object	Links related to the external work.
data[external_work][links][self]	string	URL to fetch the external work through the CMP Open API.
data[external_work][links][task]	string	URL to fetch the task associated with the external work through the CMP Open API.
data[external_work][links][sub_step]	string	URL to fetch the substep associated with the external work through the CMP Open API.

Example

{
  "event_name": "external_sub_step_started",
  "data": {
    "task": {
      "id": "5f6a0312a5963d0591015e3e",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "assets": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/assets"
      }
    },
    "step": {
      "id": "5f68911d83eeb10591933b49",
      "links": {
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e"
      }
    },
    "sub_step": {
      "id": "5f68911d83eeb10591933b4a",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "external_work": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work"
      }
    },
    "external_work": {
      "external_system": "Trello",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "sub_step": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a"
      }
    }
  }
}

external_sub_step_completed

An external substep was completed from a task.

Payload

Key	Type	Description
event_name	string	Name of the event. The value is external_sub_step_completed.
data	object	Data of the event.
data[task]	object	Data of the task associated with the external substep.
data[task][id]	string	Unique identifier of the task.
data[task][links]	object	Links related to the task.
data[task][links][self]	string	URL to fetch the task through the CMP Open API.
data[task][links][assets]	string	URL to fetch the assets associated with the task through the CMP Open API.
data[step]	object	Data of the step associated with the external substep.
data[step][id]	string	Unique identifier of the step.
data[step][links]	object	Links related to the step.
data[step][links][task]	string	URL to fetch the task associated with the step through the CMP Open API.
data[sub_step]	object	Data of the substep associated with the external substep.
data[sub_step][id]	string	Unique identifier of the substep.
data[sub_step][links]	object	Links related to the substep.
data[sub_step][links][self]	string	URL to fetch the substep through the CMP Open API.
data[sub_step][links][task]	string	URL to fetch the task associated with the substep through the CMP Open API.
data[sub_step][links][external_work]	string	URL to fetch the external work associated with the substep through the CMP Open API.
data[external_work]	object	Data of the external work associated with the external substep.
data[external_work][external_system]	string	Name of the external system associated with the external work.
data[external_work][links]	object	Links related to the external work.
data[external_work][links][self]	string	URL to fetch the external work through the CMP Open API.
data[external_work][links][task]	string	URL to fetch the task associated with the external work through the CMP Open API.
data[external_work][links][sub_step]	string	URL to fetch the substep associated with the external work through the CMP Open API.

Example

{
  "event_name": "external_sub_step_completed",
  "data": {
    "task": {
      "id": "5f6a0312a5963d0591015e3e",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "assets": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/assets"
      }
    },
    "step": {
      "id": "5f68911d83eeb10591933b49",
      "links": {
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e"
      }
    },
    "sub_step": {
      "id": "5f68911d83eeb10591933b4a",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "external_work": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work"
      }
    },
    "external_work": {
      "external_system": "Trello",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "sub_step": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a"
      }
    }
  }
}

external_sub_step_modified

The assignee or due date of an external substep was modified.

Payload

Key	Type	Description
event_name	string	Name of the event. The value is external_sub_step_modfied.
data	object	Data of the event.
data[task]	object	Data of the task associated with the external substep.
data[task][id]	string	Unique identifier of the task.
data[task][links]	object	Links related to the task.
data[task][links][self]	string	URL to fetch the task through the CMP Open API.
data[task][links][assets]	string	URL to fetch the assets associated with the task through the CMP Open API.
data[step]	object	Data of the step associated with the external substep.
data[step][id]	string	Unique identifier of the step.
data[step][links]	object	Links related to the step.
data[step][links][task]	string	URL to fetch the task associated with the step through the CMP Open API.
data[sub_step]	object	Data of the substep associated with the external substep.
data[sub_step][id]	string	Unique identifier of the substep.
data[sub_step][links]	object	Links related to the substep.
data[sub_step][links][self]	string	URL to fetch the substep through the CMP Open API.
data[sub_step][links][task]	string	URL to fetch the task associated with the substep through the CMP Open API.
data[sub_step][links][external_work]	string	URL to fetch the external work associated with the substep through the CMP Open API.
data[external_work]	object	Data of the external work associated with the external substep.
data[external_work][external_system]	string	Name of the external system associated with the external work.
data[external_work][links]	object	Links related to the external work.
data[external_work][links][self]	string	URL to fetch the external work through the CMP Open API.
data[external_work][links][task]	string	URL to fetch the task associated with the external work through the CMP Open API.
data[external_work][links][sub_step]	string	URL to fetch the substep associated with the external work through the CMP Open API.

Example

{
  "event_name": "external_sub_step_modified",
  "data": {
    "task": {
      "id": "5f6a0312a5963d0591015e3e",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "assets": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/assets"
      }
    },
    "step": {
      "id": "5f68911d83eeb10591933b49",
      "links": {
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e"
      }
    },
    "sub_step": {
      "id": "5f68911d83eeb10591933b4a",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "external_work": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work"
      }
    },
    "external_work": {
      "external_system": "Jira",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "sub_step": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a"
      }
    }
  }
}

external_sub_step_comment_added

A top-level comment was added to an external substep.

Payload

Key	Type	Description
event_name	string	Name of the event. The value is external_sub_step_comment_added.
data	object	Data of the event.
data[task]	object	Data of the task associated with the external substep.
data[task][id]	string	Unique identifier of the task.
data[task][links]	object	Links related to the task.
data[task][links][self]	string	URL to fetch the task through the CMP Open API.
data[task][links][assets]	string	URL to fetch the assets associated with the task through the CMP Open API.
data[step]	object	Data of the step associated with the external substep.
data[step][id]	string	Unique identifier of the step.
data[step][links]	object	Links related to the step.
data[step][links][task]	string	URL to fetch the task associated with the step through the CMP Open API.
data[sub_step]	object	Data of the substep associated with the external substep.
data[sub_step][id]	string	Unique identifier of the substep.
data[sub_step][links]	object	Links related to the substep.
data[sub_step][links][self]	string	URL to fetch the substep through the CMP Open API.
data[sub_step][links][task]	string	URL to fetch the task associated with the substep through the CMP Open API.
data[sub_step][links][external_work]	string	URL to fetch the external work associated with the substep through the CMP Open API.
data[sub_step][links][comments]	string	URL to fetch the comments associated with the substep through the CMP Open API.
data[comment]	object	Data of the comment.
data[comment][id]	string	Unique identifier of the comment.
data[comment][links]	object	Links related to the comment.
data[comment][links][self]	string	URL to fetch the comment through the CMP Open API.
data[comment][links][task]	string	URL to fetch the task associated with the comment through the CMP Open API.
data[comment][links][sub_step]	string	URL to fetch the substep associated with the comment through the CMP Open API.

Example

{
  "event_name": "external_sub_step_comment_added",
  "data": {
    "task": {
      "id": "5f6a0312a5963d0591015e3e",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "assets": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/assets"
      }
    },
    "step": {
      "id": "5f68911d83eeb10591933b49",
      "links": {
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e"
      }
    },
    "sub_step": {
      "id": "5f68911d83eeb10591933b4a",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "external_work": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work",
        "comments": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/comments"
      }
    },
    "comment": {
      "id": "8f68911d83eeb10591933b4q",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/comments/8f68911d83eeb10591933b4q",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "sub_step": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a"
      }
    }
  }
}

external_sub_step_comment_removed

A top-level comment was removed from an external substep.

Payload

Key	Type	Description
event_name	string	Name of the event. The value is external_sub_step_comment_removed.
data	object	Data of the event.
data[task]	object	Data of the task associated with the external substep.
data[task][id]	string	Unique identifier of the task.
data[task][links]	object	Links related to the task.
data[task][links][self]	string	URL to fetch the task through the CMP Open API.
data[task][links][assets]	string	URL to fetch the assets associated with the task through the CMP Open API.
data[step]	object	Data of the step associated with the external substep.
data[step][id]	string	Unique identifier of the step.
data[step][links]	object	Links related to the step.
data[step][links][task]	string	URL to fetch the task associated with the step through the CMP Open API.
data[sub_step]	object	Data of the substep associated with the external substep.
data[sub_step][id]	string	Unique identifier of the substep.
data[sub_step][links]	object	Links related to the substep.
data[sub_step][links][self]	string	URL to fetch the substep through the CMP Open API.
data[sub_step][links][task]	string	URL to fetch the task associated with the substep through the CMP Open API.
data[sub_step][links][external_work]	string	URL to fetch the external work associated with the substep through the CMP Open API.
data[sub_step][links][comments]	string	URL to fetch the comments associated with the substep through the CMP Open API.
data[comment]	object	Data of the comment.
data[comment][id]	string	Unique identifier of the comment.
data[comment][links]	object	Links related to the comment.
data[comment][links][task]	string	URL to fetch the task associated with the comment through the CMP Open API.
data[comment][links][sub_step]	string	URL to fetch the substep associated with the comment through the CMP Open API.

Example

{
  "event_name": "external_sub_step_comment_removed",
  "data": {
    "task": {
      "id": "5f6a0312a5963d0591015e3e",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "assets": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/assets"
      }
    },
    "step": {
      "id": "5f68911d83eeb10591933b49",
      "links": {
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e"
      }
    },
    "sub_step": {
      "id": "5f68911d83eeb10591933b4a",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "external_work": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work",
        "comments": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/comments"
      }
    },
    "comment": {
      "id": "8f68911d83eeb10591933b4q",
      "links": {
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "sub_step": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a"
      }
    }
  }
}

external_sub_step_comment_modified

A top-level comment was modified in an external substep of a task.

Payload

Key	Type	Description
event_name	string	Name of the event. The value is external_sub_step_comment_modified.
data	object	Data of the event.
data[task]	object	Data of the task associated with the external substep.
data[task][id]	string	Unique identifier of the task.
data[task][links]	object	Links related to the task.
data[task][links][self]	string	URL to fetch the task through the CMP Open API.
data[task][links][assets]	string	URL to fetch the assets associated with the task through the CMP Open API.
data[step]	object	Data of the step associated with the external substep.
data[step][id]	string	Unique identifier of the step.
data[step][links]	object	Links related to the step.
data[step][links][task]	string	URL to fetch the task associated with the step through the CMP Open API.
data[sub_step]	object	Data of the substep associated with the external substep.
data[sub_step][id]	string	Unique identifier of the substep.
data[sub_step][links]	object	Links related to the substep.
data[sub_step][links][self]	string	URL to fetch the substep through the CMP Open API.
data[sub_step][links][task]	string	URL to fetch the task associated with the substep through the CMP Open API.
data[sub_step][links][external_work]	string	URL to fetch the external work associated with the substep through the CMP Open API.
data[sub_step][links][comments]	string	URL to fetch the comments associated with the substep through the CMP Open API.
data[comment]	object	Data of the comment.
data[comment][id]	string	Unique identifier of the comment.
data[comment][links]	object	Links related to the comment.
data[comment][links][self]	string	URL to fetch the comment through the CMP Open API.
data[comment][links][task]	string	URL to fetch the task associated with the comment through the CMP Open API.
data[comment][links][sub_step]	string	URL to fetch the substep associated with the comment through the CMP Open API.

Example

{
  "event_name": "external_sub_step_comment_modified",
  "data": {
    "task": {
      "id": "5f6a0312a5963d0591015e3e",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "assets": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/assets"
      }
    },
    "step": {
      "id": "5f68911d83eeb10591933b49",
      "links": {
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e"
      }
    },
    "sub_step": {
      "id": "5f68911d83eeb10591933b4a",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "external_work": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/external-work",
        "comments": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/comments"
      }
    },
    "comment": {
      "id": "8f68911d83eeb10591933b4q",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a/comments/8f68911d83eeb10591933b4q",
        "task": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e",
        "sub_step": "https://api.cmp.optimizely.com/v3/tasks/5f6a0312a5963d0591015e3e/steps/5f68911d83eeb10591933b49/sub-steps/5f68911d83eeb10591933b4a"
      }
    }
  }
}