Remove team member

DELETE https://datafa.st/api/v1/admin/websites/{websiteId}/team

Remove a team member from the website. Owners cannot remove themselves via the API.

Owner only. Requires team:write and owner role. Website API keys cannot perform this action.

Related: Team roles

Request

Path parameters

websiteId

string

Website ObjectId. From List websites (_id field). Example: 665f0b3c4d2e1a0012345678.

Body parameters

userId

string

required

User ObjectId to remove. Get from List team. Owners cannot remove themselves.

Example request body

{
  "userId": "665f0b3c4d2e1a0012345678"
}

Response

Returns a JSON object with status: "success" and endpoint-specific fields in data.

Response fields

data[].message

string

Human-readable confirmation or status message for the operation.

Authentication

Use a dft_ account token with team:write + owner role.

A df_ website API key for the same website can also call this route when the path websiteId matches the key's website. Write access with a df_ key is capped at member level — owner-only actions such as team management require a dft_ token and owner role.

Owner only: Inviting and removing team members requires website owner role, even with a dft_ token that has team:write.

Errors

403 — Caller is not the website owner.

400 — Attempting to remove yourself.

See API errors for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown