Skip to Content
Admin APISupervisors

Admin Supervisors API

Administrative endpoints for managing supervisors and their oversight responsibilities.

List All Supervisors

Get a list of all supervisors in the system.

Endpoint: GET /v1/admin/clinic/supervisors
Authentication: Required (Admin role)

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number for pagination
page_sizeintegerNoNumber of items per page
activebooleanNoFilter by active status
specialtystringNoFilter by specialty

Example Request

GET /v1/admin/clinic/supervisors?active=true HTTP/1.1
Content-Type: application/json
X-User-Token: your_admin_token_here

Supervisor Session Notes

List Supervisor Session Notes

Get session notes under supervisor oversight.

Endpoint: GET /v1/admin/clinic/supervisors/session_notes
Authentication: Required (Admin role)

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number for pagination
page_sizeintegerNoNumber of items per page
supervisor_idintegerNoFilter by supervisor ID
statusstringNoFilter by supervision status
provider_idintegerNoFilter by provider ID

Example Request

GET /v1/admin/clinic/supervisors/session_notes?supervisor_id=171&status=pending_review HTTP/1.1
Content-Type: application/json
X-User-Token: your_admin_token_here

Get Supervisor Session Note Details

Endpoint: GET /v1/admin/clinic/supervisors/session_notes/{id}
Authentication: Required (Admin role)

Path Parameters

ParameterTypeRequiredDescription
idintegerYesSession note ID

Supervisor Appointments

List Supervisor Appointments

Get appointments under supervisor oversight.

Endpoint: GET /v1/admin/clinic/supervisors/appointments
Authentication: Required (Admin role)

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number for pagination
page_sizeintegerNoNumber of items per page
supervisor_idintegerNoFilter by supervisor ID
provider_idintegerNoFilter by provider ID
statusstringNoFilter by appointment status
supervision_statusstringNoFilter by supervision status

Example Request

GET /v1/admin/clinic/supervisors/appointments?supervisor_id=171&supervision_status=pending HTTP/1.1
Content-Type: application/json
X-User-Token: your_admin_token_here

Get Supervisor Appointment Details

Endpoint: GET /v1/admin/clinic/supervisors/appointments/{id}
Authentication: Required (Admin role)

Path Parameters

ParameterTypeRequiredDescription
idintegerYesAppointment ID

Response Format

Supervisor Response

{
  "id": 171,
  "user_id": 789,
  "first_name": "Dr. Sarah",
  "last_name": "Johnson",
  "email": "[email protected]",
  "specialty": "child_psychiatry",
  "license_number": "SUP12345",
  "active": true,
  "supervisees": [
    {
      "id": 456,
      "first_name": "Dr. Jane",
      "last_name": "Smith"
    }
  ],
  "created_at": "2023-10-20T10:00:00.000Z",
  "updated_at": "2023-10-20T15:30:00.000Z"
}

Supervisor Session Note Response

{
  "id": 123,
  "patient_id": 1049,
  "provider_id": 456,
  "supervisor_id": 171,
  "appointment_id": 789,
  "content": "Session notes content...",
  "status": "pending_supervision",
  "supervision_status": "pending_review",
  "supervision_notes": "Please review treatment plan",
  "created_at": "2023-10-20T10:00:00.000Z",
  "updated_at": "2023-10-20T15:30:00.000Z",
  "provider": {
    "id": 456,
    "first_name": "Dr. Jane",
    "last_name": "Smith"
  },
  "patient": {
    "id": 1049,
    "first_name": "John",
    "last_name": "Doe"
  }
}

Supervisor Appointment Response

{
  "id": 789,
  "patient_id": 1049,
  "provider_id": 456,
  "supervisor_id": 171,
  "scheduled_at": "2023-10-27T14:30:00.000Z",
  "status": "completed",
  "supervision_status": "reviewed",
  "supervision_notes": "Good session, continue current approach",
  "session_note": {
    "id": 123,
    "status": "approved"
  },
  "created_at": "2023-10-20T10:00:00.000Z",
  "updated_at": "2023-10-20T15:30:00.000Z"
}

Supervision Status Values

  • pending_review - Waiting for supervisor review
  • under_review - Currently being reviewed by supervisor
  • approved - Approved by supervisor
  • requires_changes - Changes requested by supervisor
  • escalated - Escalated to higher authority
  • completed - Supervision process completed

Supervisor Specialties

Common supervisor specialties include:

  • child_psychiatry - Child and adolescent psychiatry
  • adult_psychiatry - Adult psychiatry
  • clinical_psychology - Clinical psychology
  • counseling - Counseling and therapy
  • social_work - Clinical social work
  • marriage_family_therapy - Marriage and family therapy

Error Responses

403 Forbidden

{
  "errors": "Admin access required"
}

404 Not Found

{
  "errors": "Supervisor not found"
}

422 Unprocessable Entity

{
  "errors": {
    "supervisor_id": ["must exist"],
    "supervision_status": ["is not included in the list"]
  }
}

Notes

  • All admin supervisor endpoints require administrative privileges
  • Supervisors oversee the work of providers under their supervision
  • Supervision status tracking ensures compliance with regulatory requirements
  • Session notes and appointments can be filtered by supervision criteria
  • Supervisors may have different specialties and oversight responsibilities
  • The supervision process includes review, approval, and feedback mechanisms
  • Administrative oversight helps ensure quality of care and compliance
Session NotesUsers