Users

Register a new user

post

/users

Authorizations

Body

sexstring · enumrequired

Describes the user's sex

Example: female

Options: male, female, neutral, undefined

regionstring · enumrequired

Describes the region where the user is being registered

Example: north_america

Options: africa, asia, caribbean, central_america, europe, north_america, oceania, south_america, unspecified

birthYearnumber · min: 1900required

The user's birth year

Example: 1990

weightall of

Describes the user's weight in kilograms (kg) or pounds (lb)

Example: {"value":80,"unit":"kg"}

heightall of

Describes the user's height in meters (m) or inches (in)

Example: {"value":1.7,"unit":"m"}

Responses

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.prismlabs.tech/users' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "sex": "female",
    "region": "north_america",
    "birthYear": 1990,
    "weight": {
      "value": 80,
      "unit": "kg"
    },
    "height": {
      "value": 1.7,
      "unit": "m"
    }
  }'

201

400

401

403

422

500

201

{
  "id": "7f2ec6e0-b06d-42b1-b2a1-fff59a458490",
  "sex": "female",
  "region": "north_america",
  "birthYear": 1990,
  "weight": {
    "value": 80,
    "unit": "kg"
  },
  "height": {
    "value": 1.7,
    "unit": "m"
  }
}

Fetch a user

get

/users/{userId}

Authorizations

Path parameters

userIdstringrequired

Query parameters

weight-unitstring · enum

The unit in which the weight will be returned

Options: kg, lb

height-unitstring · enum

The unit in which the height will be returned

Options: m, in

Responses

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.prismlabs.tech/users/{userId}' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

500

200

{
  "id": "7f2ec6e0-b06d-42b1-b2a1-fff59a458490",
  "sex": "female",
  "region": "north_america",
  "birthYear": 1990,
  "weight": {
    "value": 80,
    "unit": "kg"
  },
  "height": {
    "value": 1.7,
    "unit": "m"
  }
}

Update a user

IMPORTANT: A user should be updated with current information (e.g. weight) before the creation a new scan.

patch

/users/{userId}

Authorizations

Path parameters

userIdstringrequired

Query parameters

weight-unitstring · enum

The unit in which the weight will be returned

Options: kg, lb

height-unitstring · enum

The unit in which the height will be returned

Options: m, in

Body

sexstring · enum

Describes the user's sex

Example: female

Options: male, female, neutral, undefined

regionstring · enum

Describes the region where the user is being registered

Example: north_america

Options: africa, asia, caribbean, central_america, europe, north_america, oceania, south_america, unspecified

birthYearnumber · min: 1900

The user's birth year

Example: 1990

weightall of

Describes the user's weight in kilograms (kg) or pounds (lb)

Example: {"value":80,"unit":"kg"}

heightall of

Describes the user's height in meters (m) or inches (in)

Example: {"value":1.7,"unit":"m"}

Responses

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

application/json;v=1

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://api.prismlabs.tech/users/{userId}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "sex": "female",
    "region": "north_america",
    "birthYear": 1990,
    "weight": {
      "value": 80,
      "unit": "kg"
    },
    "height": {
      "value": 1.7,
      "unit": "m"
    }
  }'

200

400

401

403

422

500

200

{
  "id": "7f2ec6e0-b06d-42b1-b2a1-fff59a458490",
  "sex": "female",
  "region": "north_america",
  "birthYear": 1990,
  "weight": {
    "value": 80,
    "unit": "kg"
  },
  "height": {
    "value": 1.7,
    "unit": "m"
  }
}