ApiKeys7

AppointmentConfirmation2

Appointments25

AppointmentTypes10

AutomatedEmailTemplates4

BillableItems5

Breeds5

BulkClientExport2

BulkPatientExport2

CareQueue2

CaseMilestones6

Cases5

ChatExport1

ClientAccount1

ClientCredit2

ClientExport3

Clients6

ClientStatement1

ClinicalAddenda2

ClinicConfig41

ClinicSettings2

Clocking6

Compliance1

ConsentDocuments2

DeaBooks10

DeaExport2

DentalCharts9

DeviceFormHandoffs4

DevicePush3

Devices5

DeviceSelf1

DiagnosisTerms1

DischargeSignOff2

Disclaimers7

DiscountCodes7

Drafts7

EdgePrinters3

EdgePrintJobs2

EmailVerification2

EmergencyIntake2

Erx6

Estimates30

ExamTemplates6

Expenses6

Featurebase2

FeatureFlags1

Flowboard10

FormHandoffs6

GroupCodes7

GroupVisits6

Health1

HomeAgain4

HospitalStays18

IntegrationCredentials18

InternalPrescribing1

InternalWidget1

Inventory25

InventoryApprovals5

InventoryLocations7

Invoices29

JourneyMilestones6

Kiosk4

LabPanels5

Labs21

LineItemNotes5

LocationClosures4

Locations11

Logos7

MedicationRequests7

MentorMetrics5

MessageAttachments4

Metrics31

NpsAnalytics3

NvsIntegration11

OnlineBookingReadiness1

Partners6

PatientGroups9

PatientMasses6

PatientProblems4

PatientRecordExport3

Patients21

Payments22

PaymentTokens5

Pep5

Pharmacies5

Phones2

PriceRules6

Printers7

PrintJobs4

PtoRequests6

PublicDevicePairing1

PublicEmailUnsubscribe2

PublicFileLinks2

PublicFormHandoffs1

PublicNps2

PublicPriceList5

PublicQuestionnaires4

PublicSmsConsent2

PurchaseOrders11

QiEvents9

QuestionnaireResponses7

Questionnaires18

RabiesTags10

RdvmPortal22

Recordings9

RecurringExpenses5

ReferralMessages2

Referrals20

Reminders14

Reports2

RetailItems11

Roles6

RoomDayAssignments3

RxGovernance26

SavedReports5

ScheduleItems10

ServiceCatalog5

Shifts5

ShiftSwaps8

SlotConfigurations6

SmsConsent9

Species5

StaffAvailability1

Subscriptions10

SurgicalRecords11

TagAssignments4

Tags5

TelnyxCallControl1

Templates16

TenantKnowledge5

TimeEntries5

Transparency3

Users14

Vaccinations12

VaccineAdministration3

VaccineCertificateRecords6

VaccineCertificates2

VaccineTypes5

Vendors6

Vitals2

VitalTypes6

Widget18

WidgetChatbot4

WorkItemRules5

WorkTasks13

SurgicalRecords

POST /SurgicalRecords/{id}/events

Changed on Oct 21, 2026

Request

Base URL
https://api.clinicos.vet/backend/business
Auth
HTTP bearer
TypeScript
https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/SurgicalRecords/:id/events/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Request body

titlestring required

detailsstring nullable

typestring required

colorstring nullable

isPinnedboolean

occurredAtstring date-time nullable

When the step actually happened, UTC. Omit to stamp "now" (the common live-charting case). Setting it at create time does NOT append an amendment — the amendment trail records corrections to a stamp, not the stamp itself. Validated against the same window as a correction.

createdByAiboolean

True when the event was proposed by AI transcript extraction and accepted by the user.

milestoneKindstring nullable

Marks this event as a surgical-record milestone rather than a log entry: "cut_start" or "cut_end" (ITE-785). Stamping one mirrors its time onto the matching column on the record. If a marker of that kind already exists, it is MOVED to the new time as an audited correction (returned with its amendments), never replaced. Null for an ordinary event; an unrecognised value is rejected.

implicitboolean

ITE-1330 PR2: the stamp comes from an existing console signal (entering Induction, a checklist tick, the Intubation gas entry) rather than a deliberate press. An implicit stamp only ever CREATES a marker: when one of the kind exists it is returned unchanged (200), so a repeated signal can never overwrite a time a human corrected (ITE-792). Ignored without string? CreateSurgicalTimelineEventRequest.MilestoneKind.

inventoryItemIdstring nullable

Drug events only (ignored on any other type): the inventory item administered. An id that does not resolve is dropped rather than refused — the chart entry is kept.

doseUnitstring nullable

Drug events only: unit of decimal? CreateSurgicalTimelineEventRequest.DoseAmount ("mg", "mL", "tablet"). Max 20 chars.

routestring nullable

Drug events only: route as charted ("IV", "IM", "SQ", "CRI", "PO"). Max 20 chars.

Response

Created

idstring

surgicalRecordIdstring

titlestring

detailsstring nullable

typestring

colorstring nullable

isPinnedboolean

occurredAtstring date-time

createdByAiboolean

True when the event came from AI transcript extraction (human-accepted).

milestoneKindstring nullable

"cut_start" / "cut_end" when this event IS a surgical milestone, else null (ITE-785). The console draws a distinct marker on these rather than the ordinary event card, and the record's cut columns mirror their stamps.

inventoryItemIdstring nullable

Drug events: the administered inventory item, when the entry named one (ITE-870).

doseUnitstring nullable

routestring nullable

Drug events: route of administration as charted.

createdAtstring date-time

Changes

Oct 21, 202685ee96c0bb96 Revision changes
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
Sep 30, 2026d58b40cfca93 Revision changes
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)

Operation history (6 revisions)