> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-cloud/studio/tasks/reference/update-job-description/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# updateJobDescription

> Use the updateJobDescription task to update a job's description while the job is running.

The `updateJobDescription` task lets you update the job's description while the job is running. Job descriptions provide useful context for running, completed, and canceled jobs — for example, a customer name or job intent. Descriptions are visible in Active Jobs, Jobs (Operations Manager), and Active Tasks, where listed jobs can be filtered or sorted by their descriptions.

When jobs start, they receive an optional job description that can be edited when you manually start a job. You can also pass a description in the POST body of a REST API. However, some information isn't available when the job begins — for example, a customer may need the job description to include service instance details learned during the job. Use `updateJobDescription` in those cases.

## Properties

| Incoming      | Description                                                                                                                              |
| :------------ | :--------------------------------------------------------------------------------------------------------------------------------------- |
| `description` | Required. Select the appropriate reference task, then either select a reference variable or type a new description (for a static value). |

![](/_fern-img/039ce27cd5a38d5a0e297097ef99e91b1c06b78ce0c8c5ca108aafc8b6f317e3.webp)

| Outgoing      | Description                                                                                                                                                                                       |
| :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `description` | Use this immutable variable or create a job variable. Other tasks cannot directly access job descriptions, but the new description can be read from the `updateJobDescription` outgoing variable. |

> Use the updateJobDescription task to update a job's description while the job is running.