Update Agent Insights job

PATCH

/v1/private/agent-insights/jobs/:projectId

PATCH

/api/v1/private/agent-insights/jobs/:projectId

curl -X PATCH http://localhost:5173/api/v1/private/agent-insights/jobs/projectId \
     -H "Content-Type: application/json" \
     -d '{
  "status": "enabled"
}'

{
  "project_id": "string",
  "id": "string",
  "status": "enabled",
  "auto_first_run_enrolled": true,
  "auto_first_run_at": "2024-01-15T09:30:00Z",
  "last_scan_at": "2024-01-15T09:30:00Z",
  "last_failure_reason": "string",
  "last_failure_detail": "string",
  "last_failed_at": "2024-01-15T09:30:00Z",
  "guidance": "string",
  "guidance_updated_by": "string",
  "guidance_updated_at": "2024-01-15T09:30:00Z",
  "guidance_version": 1,
  "results_guidance_version": 1,
  "created_at": "2024-01-15T09:30:00Z",
  "created_by": "string",
  "last_updated_at": "2024-01-15T09:30:00Z",
  "last_updated_by": "string"
}

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

projectIdstringRequiredformat: "uuid"

Request

This endpoint expects an object.

statusenumRequired

New status for the job

Allowed values:

Response

Job updated

project_idstringRead-onlyformat: "uuid"

idstringOptionalRead-onlyformat: "uuid"

statusenumOptionalRead-only

Allowed values:

auto_first_run_enrolledbooleanOptionalRead-only

auto_first_run_atdatetimeOptionalRead-only

last_scan_atdatetimeOptionalRead-only

last_failure_reasonstringOptionalRead-only

last_failure_detailstringOptionalRead-only

last_failed_atdatetimeOptionalRead-only

guidancestringOptionalRead-only

Project guidance sent to every run; null when none

guidance_updated_bystringOptionalRead-only

Who last saved the guidance

guidance_updated_atdatetimeOptionalRead-only

When the guidance was last saved

guidance_versionintegerOptionalRead-only

Bumped each time the guidance text changes; 0 = never saved

results_guidance_versionintegerOptionalRead-only

Guidance version the current results were produced with; null = no run since guidance existed

created_atdatetimeOptionalRead-only

created_bystringOptionalRead-only

last_updated_atdatetimeOptionalRead-only

last_updated_bystringOptionalRead-only

Errors

404

Not Found Error