---
title: "Enrol projects in the auto-first-run rollout"
method: POST
path: "/v1/internal/agent-insights/enrollment"
tags: ["Agent Insights enrollment"]
---

# Enrol projects in the auto-first-run rollout

`POST /v1/internal/agent-insights/enrollment`

Enrols the given projects, creating their job row if needed, or clears their enrolment. Idempotent.

## Request body

- Request
  - `enrolled` boolean, required — True enrols the given projects, false clears their enrolment
  - `project_ids` string[], required

## Response `200`

Enrollment result

- Response
  - `enrolled` integer
  - `cleared` integer
  - `unknown_project_ids` string[] — Ids that match no project
  - `already_run_project_ids` string[] — Ids whose automatic run already happened, so enrolling has no effect

## Changes

- **2026-09-25** `3ab3b8180ae9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/comet-ml/apis/opik-rest-api/changes/v1/internal/agent-insights/enrollment/post.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/3ab3b8180ae9?raw)