Remove a member

DELETE

/orgs/{org}/members/{userId}

curl --request DELETE \
  --url https://api.sloose.com/orgs/org_9f3c/members/usr_4b19 \
  --header 'Authorization: Bearer <token>'

• Production
• Staging

Takes the person out of the org. Their next org-scoped request is refused, and any session of theirs that was working in this org is left in no org — they are still who they are everywhere else. The way back in is another invitation.

You cannot remove yourself, nor somebody who outranks you, nor the last owner.

Session only: managing people takes a person, never an org’s API token (D5).

Authorizations

• sessionAuth

Parameters

Path Parameters

org

required

The org id the session was issued for. A token for one org can never read another.

string

Example

org_9f3c

The org id the session was issued for. A token for one org can never read another.

userId

required

The member’s user id, from the member list.

string

Example

usr_4b19

The member’s user id, from the member list.

Responses

200

Removed.

Media typeapplication/json

object

ok

required

boolean

Example

{
  "ok": true
}

401

No bearer, or one that is expired, revoked or no longer resolves to a member.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

403

An API token was used (SESSION_REQUIRED), you tried to remove yourself (SELF_CHANGE: a person leaves from Your account, POST /orgs/{org}/leave), somebody who outranks you (OUTRANKED), or the org closed as you asked (ORG_CLOSED) — asked in the removal itself.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

404

That person is not in this org (MEMBER_NOT_FOUND).

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

409

The org would be left with no owner (LAST_OWNER), or the person’s role changed between your reading it and this request, so the decision has to be made again (MEMBER_CHANGED).

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}