---
title: "Set a new monitor status."
method: PUT
path: "/fleets/{fid}/monitors/{mid}/status"
tags: ["Monitors"]
---

# Set a new monitor status.

`PUT /fleets/{fid}/monitors/{mid}/status`

## Request

- Base URL: `https://api-cert.groupe-psa.com/connectedcar/v3`
- URL: `https://api-cert.groupe-psa.com/connectedcar/v3/fleets/{fid}/monitors/{mid}/status`
- Auth: HTTP basic and API key in query parameter `client_id`
- TypeScript: <https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api/docs/fleets/:fid/monitors/:mid/status/put.ts> (a function with typed inputs; its response is checked against the schema)

Set monitor status.

## Path parameters

- `fid` string, required
- `mid` string, required

## Request body

- MonitorStatusSetter: MonitorStatusSetter
  - `status` 'Running' | 'Paused', required

## Response `202`

Monitor created or updated successfully

- MonitorRef: Monitor creation reference returned when posting a new monitor.
  - `createdAt` string, date-time, required: Date when the resource has been created.
  - `updatedAt` string, date-time, required
  - `_links` object
    - `fleet` Link: A Link Object as defined by [JSONHAL#Link Object](https://tools.ietf.org/html/draft-kelly-json-hal-08#section-5).
      - `href` string, required: URL format follows [RFC 3986](https://tools.ietf.org/html/rfc3986) and usually looks like this ` scheme://host[:port][/Path] `
      - `templated` boolean: SHOULD be true when the Link Object's "href" property is an [URI Template](https://tools.ietf.org/html/rfc6570)
      - `type` string: a hint to indicate the media type expected when dereferencing the target resource.
      - `deprecation` string: indicates that the link is to be deprecated (i.e. removed) at a future date. Its value is a URL that SHOULD provide further information about the deprecation.
      - `name` string
      - `title` string: Its value is a string and is intended for labelling the link with a human-readable identifier (as defined by [RFC5988](https://tools.ietf.org/html/rfc5988)).
      - `profile` string: Its value is a string and is intended for indicating the language of the target resource (as defined by [RFC5988]).
      - `hreflang` string: Its value is a string which is a URI that hints about the profile (as defined by [I-D.wilde-profile-link](https://tools.ietf.org/html/draft-kelly-json-hal-08#ref-I-D.wilde-profile-link)) of the target resource.
    - `monitor` Link: A Link Object as defined by [JSONHAL#Link Object](https://tools.ietf.org/html/draft-kelly-json-hal-08#section-5).
      - `href` string, required: URL format follows [RFC 3986](https://tools.ietf.org/html/rfc3986) and usually looks like this ` scheme://host[:port][/Path] `
      - `templated` boolean: SHOULD be true when the Link Object's "href" property is an [URI Template](https://tools.ietf.org/html/rfc6570)
      - `type` string: a hint to indicate the media type expected when dereferencing the target resource.
      - `deprecation` string: indicates that the link is to be deprecated (i.e. removed) at a future date. Its value is a URL that SHOULD provide further information about the deprecation.
      - `name` string
      - `title` string: Its value is a string and is intended for labelling the link with a human-readable identifier (as defined by [RFC5988](https://tools.ietf.org/html/rfc5988)).
      - `profile` string: Its value is a string and is intended for indicating the language of the target resource (as defined by [RFC5988]).
      - `hreflang` string: Its value is a string which is a URI that hints about the profile (as defined by [I-D.wilde-profile-link](https://tools.ietf.org/html/draft-kelly-json-hal-08#ref-I-D.wilde-profile-link)) of the target resource.
  - `monitorId` string, required: Uniq monitor ID returned when the monitor was created succefully.
  - `status` 'Running' | 'Paused' | 'Failed', required

## Other responses

- `default` (unresolved $ref)

---

[API](https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api.md) - [All operations](https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api/llms.txt) - [OpenAPI document](https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api/revisions/023ff3e3fe51?raw)