# Share a webhook service with your family, or unshare it

Only the original creator can share or unshare. Set familyId to your family ID, or null to unshare. Accepted family members receive shared alerts with independent inbox read state. Family owners can rename or delete shared services, but only the original creator can rotate or see the webhook token. A creator leaving the family automatically unshares their services.

HTML: https://notify.belweave.ai/docs/api/postServicesIdShare

Required scopes: `services:write`

```http
POST /api/agent/services/{id}/share
Authorization: Bearer ntf_your_token
```

## Operation schema

```json
{
  "summary": "Share a webhook service with your family, or unshare it",
  "description": "Only the original creator can share or unshare. Set familyId to your family ID, or null to unshare. Accepted family members receive shared alerts with independent inbox read state. Family owners can rename or delete shared services, but only the original creator can rotate or see the webhook token. A creator leaving the family automatically unshares their services.",
  "operationId": "postServicesIdShare",
  "security": [
    {
      "bearer": [
        "services:write"
      ]
    }
  ],
  "x-notify-scopes": [
    "services:write"
  ],
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "schema": {
        "type": "string"
      },
      "required": true
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "familyId": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "familyId"
          ],
          "additionalProperties": false
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Success",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "service": {
                "$ref": "#/components/schemas/AgentService"
              }
            },
            "required": [
              "service"
            ]
          }
        }
      }
    },
    "400": {
      "description": "Invalid request",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "401": {
      "description": "Missing, unknown, revoked, or expired token",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "403": {
      "description": "The token lacks a required scope or the account lacks permission",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "404": {
      "description": "Not found for this account",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}
```

Resolve schema references against [OpenAPI](https://notify.belweave.ai/openapi.json).