---
title: "Remove a domain membership from a student"
method: DELETE
path: "/v2/students/{id}/relationships/domain-memberships/{domain_id}"
tags: ["Students"]
---

# Remove a domain membership from a student

`DELETE /v2/students/{id}/relationships/domain-memberships/{domain_id}`

## Request

- Base URL: `https://api.skilljar.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.skilljar.com/v2/students/{id}/relationships/domain-memberships/{domain_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/skilljar/apis/skilljar-api-v2/docs/v2/students/:id/relationships/domain-memberships/:domain_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Remove a single domain membership from a student (soft-deactivate).

Identifies the membership by the ``(student, domain)`` pair: the student is
the ``{id}`` path segment, the domain is ``{domain_id}``. DELETE
**deactivates** the membership (``active=False``, ``expires_at=now``) rather
than destroying the row — the mirror of the (re)activating POST, and what the
dashboard does — so history is preserved and a later POST can reactivate it.

Returns 204 on success, 404 if the student, the domain, or the membership
does not exist in the caller's organization. Deactivating an already-inactive
membership is an idempotent 204 no-op (no event); the removed event fires
only on an actual active → inactive transition.

**Required OAuth scope:** `students:write`

## Path parameters

- `id` string, required
- `domain_id` string, required

## Response `204`

No Content

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `406`: Not Acceptable: Accept rules out application/vnd.api+json.

## Changes

- **2026-10-16** `bed169429eb2`: 1 info
  - added the non-success response with the status `406`
- **2026-09-15** `9fc34e55336d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skilljar/apis/skilljar-api-v2/changes/v2/students/:id/relationships/domain-memberships/:domain_id/delete.md)

---

[API](https://skmtc.dev/skilljar/apis/skilljar-api-v2.md) - [All operations](https://skmtc.dev/skilljar/apis/skilljar-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/skilljar/apis/skilljar-api-v2/revisions/fbda30ce1742?raw)