Member left (YWC)

Yacht Workers Council only. Other partners receive insufficient_scope (403). Auth is the same HTTP Basic as the rest of /v1/partners/*.

POST /v1/partners/members/left
Authorization: Basic <base64(client_id:client_secret)>
Content-Type: application/json

Call this when a member is no longer in YWC — they left, their membership lapsed, or they deleted their YWC account. DSS closes the billed Crew Premium seat (James stops paying from that UTC day) and drops sponsored Premium unless the member already pays for Crew Premium themselves. This is not a DSS account deletion. reason: "account_deleted" means the YWC account is gone, not the DSS user. Do not call the dashboard internal URL. One successful call is enough; retries are safe.

Request

Field	Type	Required	Notes
`user_id`	string	If no resolvable `external_ref`	DSS user id from Connect (Firebase uid). Preferred.
`external_ref`	string	If no `user_id`	Your id, e.g. `ywc-user-123`. Used only when `user_id` is omitted; we look up the DSS user from a prior sponsorship row.
`reason`	string	No	`membership_lapsed` or `account_deleted`. Both close the billed seat the same way.

{
  "user_id": "aQ0mtT8kRgVv7C3o1p2q3r4s5t6u",
  "external_ref": "ywc-user-123",
  "reason": "membership_lapsed"
}

curl -u "$DSS_CLIENT_ID:$DSS_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"<dss-uid>","external_ref":"ywc-user-123","reason":"membership_lapsed"}' \
  https://api.digitalseaservice.com/v1/partners/members/left

Sandbox: https://api.dev.digitalseaservice.com/v1/partners/members/left.

Response

200 OK — including when the seat was already closed.

Field	Type	Notes
`user_id`	string	DSS user we closed the seat for.
`ended`	boolean	`true` when an open billed seat was closed this call.
`downgraded`	boolean	`true` when sponsored Crew Premium was dropped. `false` if they already self-pay, or the seat was already closed.

{
  "user_id": "aQ0mtT8kRgVv7C3o1p2q3r4s5t6u",
  "ended": true,
  "downgraded": true
}

We also revoke that member’s live YWC OAuth tokens so a later reconcile cannot re-open James’s seat.

Errors

Status	`type`	When
400	`invalid_request`	Neither `user_id` nor a resolvable `external_ref`.
401	`invalid_token`	Missing or bad Basic credentials.
403	`insufficient_scope`	Not Yacht Workers Council, or the partner is suspended.
422	`invalid_request`	`reason` is present but not `membership_lapsed` or `account_deleted`.
503	`service_unavailable`	Dashboard member-left failed. Retry with backoff; the call is idempotent.

Sponsorship API overview
Remove a seat — JIT sponsorship program seats, not Connect-billed YWC Premium

Get started

Webhooks

Errors

Partner sponsorships (restricted)

Resources

Request

Response

Errors

​Request

​Response

​Errors

​Related

Request

Response

Errors

Related