Members

Kick a member

Moves the member to churned, removes them from every resource and emits member.kicked with the optional reason. Unlike a ban, a kicked member may come back by subscribing again. Answers 200 with the member; a banned member is answered unchanged, since a ban already says more. As with a ban, the connector-side eviction completes in the background after the call returns.

post/v1/projects/{project}/members/{member}/kick

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/members/{member}/kick
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

memberstring uuid required

The member, resolved within the project by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Request body

reasonstring

Why the member is removed; carried on the member.kicked event and shown in the dashboard, never sent to the member.

Response

The member after the change.

Example response

{
  "data": {
    "id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "username": "@janedoe",
    "first_name": "Jane",
    "last_name": "Doe",
    "billing_email": "jane@example.com",
    "identities": [
      {
        "id": "6a1f0c3e-2d4b-4e8a-9c7d-1b5e3f9a2c4d",
        "connector": "telegram",
        "source": "handshake",
        "preferred": true,
        "external_id": "123456789",
        "display_name": "Jane Doe",
        "username": "janedoe",
        "linked_at": "2026-05-18T10:05:00Z"
      }
    ],
    "status": "customer",
    "joined_at": "2026-05-18T10:05:00Z",
    "created_at": "2026-05-18T10:05:00Z",
    "updated_at": "2026-05-18T10:05:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.