# Create Medication Request

Create a new medication request for a patient. This endpoint initiates the prescription and fulfillment process.

Notes:
- Patient and practitioner must already exist in the system
- Medication details must be valid
- The request will be validated against the clinic's available medications

Endpoint: POST /api/external/medication-request
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `clinic_id` (string, required)
    UUID of the clinic
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `patient_id` (string, required)
    UUID of the patient
    Example: "770e8400-e29b-41d4-a716-446655440002"

  - `practitioner_id` (string, required)
    UUID of the prescribing practitioner
    Example: "660e8400-e29b-41d4-a716-446655440001"

  - `medication_name` (string, required)
    Name of the medication
    Example: "Testosterone Cypionate"

  - `medication_strength` (string)
    Medication strength/concentration
    Example: "200mg/ml"

  - `quantity` (integer, required)
    Quantity to dispense
    Example: 1

  - `refills` (integer)
    Number of refills authorized
    Example: 3

  - `days_supply` (integer)
    Days supply per fill
    Example: 30

  - `instructions` (string)
    Dosing instructions for the patient
    Example: "Inject 0.5ml (100mg) intramuscularly twice weekly"

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (object)

  - `data.medication_request_id` (string)
    Unique identifier for the medication request
    Example: "880e8400-e29b-41d4-a716-446655440003"

  - `message` (string)
    Example: "Medication request created successfully"

## Response 400 fields (application/json):

  - `success` (boolean)

  - `error` (object)

  - `error.message` (string)
    Human-readable error message
    Example: "Validation error"

  - `error.details` (object)
    Additional error details
    Example: {}

## Response 401 fields (application/json):

  - `success` (boolean)

  - `error` (object)

  - `error.message` (string)
    Human-readable error message
    Example: "Validation error"

  - `error.details` (object)
    Additional error details
    Example: {}

## Response 404 fields (application/json):

  - `success` (boolean)

  - `error` (object)

  - `error.message` (string)
    Human-readable error message
    Example: "Validation error"

  - `error.details` (object)
    Additional error details
    Example: {}