# Custom jobs

> Custom jobs - Create custom jobs in the Model Registry to define tests for your models and
> deployments.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-04-24T16:03:56.569356+00:00` (UTC).

## Primary page

- [Custom jobs](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/registry/reg-custom-jobs.html): Full documentation for this topic (HTML).

## Sections on this page

- [Register and assemble a new job](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/registry/reg-custom-jobs.html#register-and-assemble-a-new-job): In-page section heading.
- [Run and schedule jobs](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/registry/reg-custom-jobs.html#run-and-schedule-jobs): In-page section heading.
- [View and edit jobs info](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/registry/reg-custom-jobs.html#view-and-edit-jobs-info): In-page section heading.
- [View and manage job runs](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/registry/reg-custom-jobs.html#view-and-manage-job-runs): In-page section heading.
- [Delete a custom job](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/registry/reg-custom-jobs.html#delete-a-custom-job): In-page section heading.

## Related documentation

- [Classic UI documentation](https://docs.datarobot.com/en/docs/classic-ui/index.html): Linked from this page.
- [MLOps](https://docs.datarobot.com/en/docs/classic-ui/mlops/index.html): Linked from this page.
- [Deployment](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/index.html): Linked from this page.
- [Register models](https://docs.datarobot.com/en/docs/classic-ui/mlops/deployment/registry/index.html): Linked from this page.

## Documentation content

# Custom jobs

Create custom jobs in the Model Registry to implement automation (for example, custom tests) for your models and deployments. Each job serves as an automated workload, and the exit code determines if it passed or failed. You can run the custom jobs you create for one or more models or deployments. The automated workloads you define through custom jobs can make prediction requests, fetch inputs, and store outputs using DataRobot's Public API.

## Register and assemble a new job

When you register a custom job, you must assemble the required execution environment and files before running the job. Only the execution environment and an entry point file (typically `run.sh`) are required; however, you can designate any file you add as the entry point. If you add other files to create your job, the entry point file should reference those files. In addition, to configure runtime parameters, you should create or upload a `metadata.yaml` file containing the runtime parameter configuration for your job.

To register and assemble a new custom job in the Model Registry:

1. ClickModel Registry > Custom Jobs, and then clickRegister new job.
2. In theRegister new jobdialog box, enter aJob nameandDescription (optional)and then clickCreate new job. The custom job opens in theWorkshoptab.
3. In theCustom Job Workshopfor the new job, underEnvironment and Description, select anExecution Environmentfor the job and (optionally) edit theDescription.
4. In theContentsection, assemble your custom job. You can use the options in this section to create or upload the files required to assemble a custom job: OptionDescriptionAdd filesUpload existing custom job files (run.sh,metadata.yaml, etc.).Create fileCreate a blank file and add contents in DataRobot.The default file name for a file created this way isrun.sh; however, you can edit that name before saving the file. If you've already added arun.shfile and you create another file without changing the default name, the new file overwrites the previously created or uploadedrun.shfile.
5. In theSettingssection, define theEntry pointfile. If you've only added one file (usuallyrun.sh), that file is the entry point.
6. (Optional) In theSettingssection, if you uploaded ametadata.yamlfile, configure theRuntime Parameters.

## Run and schedule jobs

After you register and assemble a custom job with the required environment and files, you can run the job, schedule a run, or both. In the Model Registry, on the Custom Jobs > Workshop tab, locate the run options next to the Custom Jobs Workshop header:

| Option | Description |
| --- | --- |
| Run | Starts a custom job run immediately and opens the run on the Runs tab, where you can view custom job run information. |
| Schedule run | Opens the Schedule run (UTC) section, where you can select a frequency and enter a time (in UTC) to run your custom job. You can also click Use advanced scheduler to provide a more precise run schedule. Once you've configured a schedule, click Set schedule. |

## View and edit jobs info

After you register a custom job, you can view and edit the registration info. In the Model Registry, on the Custom Jobs > Info tab, locate the Custom Job Info. You can view the custom job ID, and the created, updated, and last run information. You can also edit the Name and Description of the custom job. To edit those fields, click the edit icon ( [https://docs.datarobot.com/en/docs/images/icon-pencil.png](https://docs.datarobot.com/en/docs/images/icon-pencil.png)) next to the field contents:

## View and manage job runs

When you run a custom job (or a scheduled run completes), the run information is recorded, allowing you to review the run information and view and manage run logs. This is helpful for diagnosing issues when a run fails. In the Model Registry, on the Custom Jobs > Runs tab, locate and click the run you want to view from the list and review the Custom job run info:

> [!WARNING] Warning
> Do not log sensitive information in your custom job code. The logs for a custom job run contain any information logged in that job's code. If you log sensitive information, you should delete your logs.

| Field | Description |
| --- | --- |
| Job results | The Status and Duration of the selected job run. |
| Description | A description of the job run. To edit the description, click the edit icon () next to the field contents. |
| Logs of the run | Provides the following log controls: View full logs: Open the Console Logs window in DataRobot where you can Search, Download, and Refresh the log contents. You can view logs while the run is still in progress, clicking Refresh to keep them up to date. Download logs: Download the logs as a .txt file.Delete logs: Permanently delete the logs for a run, typically if you accidentally logged sensitive information. |

If you uploaded a `metadata.yaml` file and configured Runtime Parameters during the custom jobs assembly process, you can view them in the Runtime Parameters table for a run:

You can also initiate or schedule runs from the Runs tab:

## Delete a custom job

To delete a custom job and all of its contents, in the Model Registry, on the Custom Jobs tab, locate the row for the custom job you want to delete, click the action menu ( [https://docs.datarobot.com/en/docs/images/icon-menu.png](https://docs.datarobot.com/en/docs/images/icon-menu.png)), and click Delete. Then, in the Delete Custom Job dialog box, click Delete again.