---
title: "Share a signal with one or more teammates"
method: POST
path: "/api/me/signals/{id}/share"
tags: ["me"]
---

# Share a signal with one or more teammates

`POST /api/me/signals/{id}/share`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/signals/{id}/share`
- Auth: none declared

All roles can share. Server validates each recipient is a current customer_users member of the same customer, drops self + already-shared recipients, and fires a shared_with_me notification (in-app + email per recipient prefs).

## Path parameters

- `id` string, uuid, required

## Request body

- ShareSignalBody
  - `recipientUserIds` string[], required: Teammates to share with. Must be current customer_users members.
  - `message` string: Optional note from the sharer. Empty/omitted → "shared without comment".

## Response `201`

Shares created

- ShareSignalResponse
  - `shares` object[], required
    - `id` string, uuid, required
    - `signalId` string, uuid, required
    - `toUserId` string, uuid, required
    - `message` string, nullable, required
    - `createdAt` string, date-time, required

## Other responses

- `400`: Validation error / self-share / invalid recipients
- `404`: Signal not found in this customer
- `409`: All recipients were already shared with — nothing to do

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)