---
title: "Update Agent Insights job"
method: PATCH
path: "/v1/private/agent-insights/jobs/{projectId}"
tags: ["Agent Insights Jobs"]
---

# Update Agent Insights job

`PATCH /v1/private/agent-insights/jobs/{projectId}`

Partially updates the Agent Insights job for a project (e.g. status; never deletes). Returns the updated job, or 404 if none exists.

## Path parameters

- `projectId` string, uuid, required

## Request body

- AgentInsightsJobUpdate
  - `status` 'enabled' | 'disabled', required — New status for the job

## Response `200`

Job updated

- AgentInsightsJob
  - `id` string, uuid
  - `project_id` string, uuid, required
  - `status` 'enabled' | 'disabled'
  - `last_scan_at` string, date-time
  - `last_failure_reason` string
  - `last_failure_detail` string
  - `last_failed_at` string, date-time
  - `created_at` string, date-time
  - `created_by` string
  - `last_updated_at` string, date-time
  - `last_updated_by` string

## Other responses

- `404` — Job not found

## Changes

- **2026-07-02** `3144ea40dac0` — 3 info
  - added the optional property `last_failed_at` to the response with the `200` status
  - added the optional property `last_failure_detail` to the response with the `200` status
  - added the optional property `last_failure_reason` to the response with the `200` status
- **2026-06-23** `d4ccb2feb097` — 1 info
  - added the optional property `last_scan_at` to the response with the `200` status
- **2026-06-19** `78b5cd88d461` — 1 info
  - endpoint added
- **2026-05-04** `d606e84c75e4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/comet-ml/apis/opik-rest-api/changes/v1/private/agent-insights/jobs/:projectId/patch.md)

---

[API](https://skmtc.dev/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.dev/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/comet-ml/apis/opik-rest-api/revisions/7e9b9ca95d8f?raw)