---
title: "Changes to Create and run a metric collection job"
method: POST
path: "/v1/metric/collection-jobs"
---

# Changes to Create and run a metric collection job

`POST /v1/metric/collection-jobs`

> Every recorded change to this operation, newest first.
> 188 revisions in range; 1 not diffed.

## Timeline

Changed in 3 of 188 revisions.

- **2026-10-17** `2bb78f0ffcdc`: 3 info
- **2026-08-26** `b4a59c7057ca`: 1 info
- **2026-08-17** `887b091b3d81`: 10 warning

## Changes

- **2026-10-17** `2bb78f0ffcdc`: 3 info
  - added the new optional request property `policyId`
  - the request property `metrics` became optional
  - added the non-success response with the status `404`
- **2026-08-26** `b4a59c7057ca`: 1 info
  - added the non-success response with the status `402`
- **2026-08-17** `887b091b3d81`: 10 warning
  - added the new `conflict` enum value to the `type` response property for the response status `400`
  - added the new `conflict` enum value to the `type` response property for the response status `401`
  - added the new `conflict` enum value to the `type` response property for the response status `403`
  - added the new `conflict` enum value to the `type` response property for the response status `429`
  - added the new `conflict` enum value to the `type` response property for the response status `500`
  - added the new `payment_required` enum value to the `type` response property for the response status `400`
  - added the new `payment_required` enum value to the `type` response property for the response status `401`
  - added the new `payment_required` enum value to the `type` response property for the response status `403`
  - added the new `payment_required` enum value to the `type` response property for the response status `429`
  - added the new `payment_required` enum value to the `type` response property for the response status `500`

---

[Operation](https://skmtc.dev/roarkhq/apis/roark-analytics-api/docs/v1/metric/collection-jobs/post.md) - [API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [Page](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/metric/collection-jobs/post)