---
title: "Send Test"
method: POST
path: "/notifications/test"
tags: ["notifications"]
---

# Send Test

`POST /notifications/test`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/notifications/test`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Sends a test message now to each channel the scope's alerts go to (its own settings, else
the organisation's default): email, Slack and the webhook; answers what happened on each.

## Request body

- NotificationTestIn
  - `workspace_id` string, uuid, nullable

## Response `200`

Successful Response

- NotificationTest
  - `workspace_id` string, uuid, nullable, required
  - `email` ChannelTest, required
    - `outcome` 'sent' | 'not_configured' | 'failed', required
    - `detail` string, nullable
  - `slack` ChannelTest, required
    - `outcome` 'sent' | 'not_configured' | 'failed', required
    - `detail` string, nullable
  - `webhook` ChannelTest, required
    - `outcome` 'sent' | 'not_configured' | 'failed', required
    - `detail` string, nullable

## Other responses

- `422`: Validation Error

---

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