---
title: "Perform a member's next step"
method: POST
path: "/v1/members/{membership_id}/next-step"
tags: ["members"]
---

# Perform a member's next step

`POST /v1/members/{membership_id}/next-step`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/members/{membership_id}/next-step`
- Auth: HTTP bearer

Perform the next action derived from current member state.

## Path parameters

- `membership_id` string, uuid, required

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- MemberNextStepResponse: The outcome and selected lane for one member's current next step.
  - `membership_id` string, uuid, required
  - `outcome` 'invited_dm' | 'invited_email' | 'reminded_email' | 'skipped_activated' | 'skipped_rate_limited' | 'skipped_no_second_hello' | 'skipped_unknown_history' | 'skipped_already_queued' | 'skipped_guest' | 'skipped_guest_unverified' | 'skipped_no_channel' | 'skipped_attempts_exhausted' | 'skipped_deactivated' | 'skipped_email_suppressed' | 'skipped_owner_role' | 'failed' | 'invited_to_platform' | 'email_invite_sent' | 'skipped_nothing_to_do', required: The result of one server-derived member action.
  - `channel` 'slack_dm' | 'teams_dm' | 'email', required: The delivery lane selected for one member.

## Other responses

- `422`: Validation Error

---

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