---
title: "Update message"
method: PUT
path: "/rts/messages/{message_id}/"
tags: ["rts_messages"]
---

# Update message

`PUT /rts/messages/{message_id}/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/rts/messages/{message_id}/`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://my.angelcam.com/oauth/authorize/`, token URL `https://my.angelcam.com/oauth/token/`
    - Password, token URL `https://api.angelcam.com/oauth/token/`
    - Scopes: `messages_manage`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/angelcam/apis/angelcam-api/docs/rts/messages/:message_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Update messages

## Path parameters

- `message_id` integer, required

## Request body

- object
  - `is_read` boolean: Was message read by user?

## Response `200`

OK

- MessageObject
  - `id` number, required: Message ID
  - `created_at` string, required: Time when message was created, format `%Y-%m-%dT%H:%M:%SZ`
  - `title` string, required: Message title
  - `type` 'my_incident' | 'shared_incident' | 'arming' | 'trigger_action' | 'open_incident_verification' | 'verify_incident' | 'close_incident' | 'arrow_status_online' | 'arrow_status_offline' | 'camera_status_online' | 'camera_status_offline', required: Message type. Can be used to decide for instance priority of the message.
  - `short_message` string, required: Short version of message. Use short version for example in notification list
  - `long_message` string, required: More detailed version of message. Use long version in message detail or when sending via e-mail.
  - `is_read` boolean, required: Whether message was read by user.
  - `read_at` string: Time when message was read, format `%Y-%m-%dT%H:%M:%SZ`
  - `image` string: URL of image that is related to the message.
  - `action_url` string: URL to a particular screen in webapp or mobile app that is related to this message. Required when `show_detail == false`
  - `action_label` string: Label for button that should redirect to action_url
  - `show_detail` boolean, required: Whether to show detail of message or redirect user directly to `action_url`
  - `incident_sharing_url` string: URL that can be used for incident verification by third parties. The URL leads to a web page where all cameras from the affected location can be viewed (live streams + the last two hours of recording). The URL is valid for one hour after the corresponding incident is created. This field will be `null` if the message type isn't `my_incident` or if the URL is no longer valid.

## Other responses

- `401`: Missing or invalid authorization.
- `403`: Missing permission.
- `404`: The specified resource was not found

---

[API](https://skmtc.dev/angelcam/apis/angelcam-api.md) - [All operations](https://skmtc.dev/angelcam/apis/angelcam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/angelcam/apis/angelcam-api/revisions/dd1cdc3f2c23?raw)