Skip to main content

Memberships

Salon team management. The owner creates invite tokens, masters accept invitations.
All endpoints require authentication.

List Members​

GET /api/v1/salons/:id/memberships

List of team members. Salon owner only.

Response 200​

{
  "success": true,
  "status": "200",
  "message": "Memberships retrieved successfully",
  "errors": null,
  "data": [
    {
      "id": "uuid",
      "role": "master",
      "status": "active",
      "invite_token": null,
      "invited_at": "2026-03-01T10:00:00Z",
      "accepted_at": "2026-03-02T09:00:00Z",
      "user": {
        "id": "uuid",
        "first_name": "Ion",
        "last_name": "Popescu"
      }
    }
  ]
}

Invite Member​

POST /api/v1/salons/:id/memberships

Create a team invitation. Salon owner only.
Returns an invite_token — passed to the master to accept via a separate endpoint.

Request​

{
  "membership": {
    "role": "master"
  }
}
FieldAllowed values
rolemaster, receptionist

Response 201​

{
  "success": true,
  "status": "201",
  "message": "Invitation created successfully",
  "errors": null,
  "data": {
    "id": "uuid",
    "role": "master",
    "status": "pending",
    "invite_token": "abc123xyz",
    "invited_at": "2026-04-06T12:00:00Z",
    "accepted_at": null,
    "user": null
  }
}

Remove Member​

DELETE /api/v1/salons/:id/memberships/:mid

Deactivate a team member. Salon owner only.

Response 200​

{
  "success": true,
  "status": "200",
  "message": "Membership deactivated successfully",
  "errors": null,
  "data": null
}

Accept Invitation​

POST /api/v1/invitations/:token/accept

Accept a team invitation. Requires authentication (master must be logged in).

Request​

POST /api/v1/invitations/abc123xyz/accept
Authorization: Bearer <token>

Response 200​

{
  "success": true,
  "status": "200",
  "message": "Invitation accepted successfully",
  "errors": null,
  "data": null
}

Response 404 — Token not found or already used​

{
  "success": false,
  "status": "404",
  "message": "Invitation not found",
  "errors": null,
  "data": null
}