Create Student Medical Condition

POST 
/students/:communityId/medical/conditions

Create a medical condition record for a student.

For a list of all medical conditions, go to Lookup - Medical Condition.
For a list of all medical severities, go to Lookup - Medical Severity.
For a list of all medical equipment, go to Lookup - Medical Equipment.

Request

Path Parameters

communityId uuidrequired

The unique identifier of the community member.

application/json

Body

required

Create medical condition payload

medicalCondition objectrequired

id uuidrequired

Lookup - Medical Condition

medicalSeverity objectrequired

id uuidrequired

Lookup - Medical Severity

medicalEquipment object[]required
Array [
id uuidrequired
Lookup - Medical Equipment
]
active booleanrequired
confidential booleanrequired
notifiedById stringnullablerequired
notifiedStartDate daterequired
conditionEndDate datenullablerequired
conditionDetails stringnullablerequired
emergencyTreatmentDetails stringnullablerequired
otherTreatmentDetails stringnullablerequired
visibility stringrequired

Possible values: [B, C, M, S]

Responses

201

Created

application/json

Schema

Schema

code stringrequired

Status Code

data object

id uuidrequired

medicalCondition objectrequired

id uuidrequired

Lookup - Medical Condition

description stringrequired

medicalSeverity objectrequired

id uuidrequired

Lookup - Medical Severity

description stringrequired

medicalEquipment object[]required

Array [

id uuidrequired

Lookup - Medical Equipment

description stringrequired

]

active booleanrequired

confidential booleanrequired

notifiedById stringnullablerequired

notifiedStartDate daterequired

conditionEndDate datenullablerequired

conditionDetails stringnullablerequired

emergencyTreatmentDetails stringnullablerequired

otherTreatmentDetails stringnullablerequired

visibility stringrequired

Possible values: [B, C, M, S]

Example (from schema)

{
  "code": "OK",
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "medicalCondition": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "description": "string"
    },
    "medicalSeverity": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "description": "string"
    },
    "medicalEquipment": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "description": "string"
      }
    ],
    "active": true,
    "confidential": true,
    "notifiedById": "string",
    "notifiedStartDate": "2025-03-12",
    "conditionEndDate": "2025-03-12",
    "conditionDetails": "string",
    "emergencyTreatmentDetails": "string",
    "otherTreatmentDetails": "string",
    "visibility": "B"
  }
}

Successful

{
  "code": "CREATED",
  "data": {
    "active": false,
    "notifiedStartDate": "2023-11-01",
    "conditionEndDate": "2023-12-01",
    "conditionDetails": "Patient recovered",
    "emergencyTreatmentDetails": "None",
    "otherTreatmentDetails": "Physical therapy",
    "visibility": "B",
    "id": "a12345bc-c463-460d-a0cc-8d1f8cf4ed3c",
    "medicalCondition": {
      "id": "24686ef6-3ff5-4110-91e2-19bed1050e43",
      "description": "Hearing"
    },
    "medicalSeverity": {
      "id": "2dbb9bd7-ab9d-43e4-b609-d9db00e85722",
      "description": "Moderate"
    },
    "medicalEquipment": [
      {
        "id": "5d994433-3eb4-43ba-b1d1-f32859042d8b",
        "description": "Hearing aid"
      }
    ],
    "confidential": true,
    "notifiedById": "3ee7b724-b8a3-432a-ac16-257852e1db8c"
  }
}

400

Bad Request

application/json

Schema

Schema

errors object[]required
Array [
code stringrequired
message stringrequired
]

Example (from schema)

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "errors": [
    {
      "code": "PA1100",
      "message": "Bad Request"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

errors object[]required
Array [
code stringrequired
message stringrequired
]

Example (from schema)

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "errors": [
    {
      "code": "PA1101",
      "message": "Unauthorized"
    }
  ]
}

403

Forbidden

application/json

Schema

Schema

errors object[]required
Array [
code stringrequired
message stringrequired
]

Example (from schema)

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "errors": [
    {
      "code": "PA1102",
      "message": "Forbidden"
    }
  ]
}

404

Resource not found

application/json

Schema

Schema

errors object[]required
Array [
code stringrequired
message stringrequired
]

Example (from schema)

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "errors": [
    {
      "code": "PA1103",
      "message": "Not Found"
    }
  ]
}

422

Unprocessable entity

application/json

Schema

Schema

errors object[]required
Array [
code stringrequired
message stringrequired
]

Example (from schema)

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "errors": [
    {
      "code": "PA1108",
      "message": "Unprocessable Entity"
    }
  ]
}

500

Internal Server Error

application/json

Schema

Schema

errors object[]required
Array [
code stringrequired
message stringrequired
]

Example (from schema)

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "errors": [
    {
      "code": "PA1109",
      "message": "Internal Server Error"
    }
  ]
}

Loading...