FalconryScale
DevelopersAPI reference

Delete a medication course

Permanently deletes a medication course and its whole dose log. This cannot be undone. To simply finish a course, set its endDate with update_medication instead. Before deleting, confirm the course (name, raptor, dates) with the user.

DELETE
/medications/{medicationId}

Authorization

bearerAuth
headerAuthorizationBearer <token>

A Clerk user API key or OAuth access token carrying the falconry:read and/or falconry:write scope.

Path Parameters

medicationId*string

A medication course's id, from list_medications.

Lengthlength <= 64

Response Body

Delete a medication course

application/json
  1. response
ok*boolean
Example Request
curl -X DELETE 'https://app.falconryscale.com/api/v1/medications/string'
Example Response
{
  "ok": true
}

Update a medication course

Edits a medication course, for example to change the dosage or set an end date to finish it. Only the fields you send change; null clears an optional field.

Log a medication dose

Records whether one day's dose was taken, missed or skipped. Logging the same date again replaces that day's entry. Returns the course with its updated dose log.