Get a team member by id

Returns ONE staff account’s directory record (id, name, email, primary role label, store scope and the active flag). Use it to confirm who you are about to act on before a write, and — because updateTeamMember REPLACES the whole record — to read the current values you must send back unchanged. The role here is a presentational label, not a grant: it tells you what the directory calls this person, not what their token is allowed to do. 404s when no member carries the id.

GET /v1/team/{memberId}

Error

A valid request URL is required to generate request examples

200

{
  "id": "user-julie",
  "name": "Julie Ferrand",
  "email": "[e-mail]",
  "role": "manager",
  "store": "Magasin Bastille",
  "active": true
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Authorizations

Authorization · string · header · required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Path Parameters

memberId · string · required

Minimum string length: 1

Response

200

application/json

The team member's directory record.

The team member's directory record.

id · string · required

Minimum string length: 1

name · string · required

Minimum string length: 1

email · string<email> · required

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

role · string · required

Minimum string length: 1

store · string · required

Minimum string length: 1

active · boolean · required