Resources

Every bookable resource , aircraft, simulators, and rooms together. Use /resources/aircraft, /simulators, or /rooms for one kind.

Adds a resource to your organization. Requires the admin role.

Fetches one resource by id.

Changes the fields you send and leaves the rest alone. Requires the admin role.

Removes the resource. Requires the admin role.

Only resources whose type is an aircraft. Defaults to the aircraft you OPERATE: customer aircraft in your shop are excluded unless you ask for them with scope, and asking requires an owner, admin, dispatcher or technician role.

Only resources whose type is a room.

Only resources whose type is a simulator.

Checks someone out on an aircraft. Requires the admin role.

The members checked out to book this aircraft , the read in the opposite direction to GET /users/{userId}/approvedResources. Use this rather than asking every member what they are approved for.

Each component on the aircraft with life: its time since new or overhaul now (from the aircraft's meter on the clock it counts on, tach unless said), the life left on each limit, and status (amber dueSoon inside 10% of a limit or 10 hours, or 10% of a calendar limit or 30 days; overdue at or past it). Components that came off only with removed=true. All hours are TENTHS. Works on the organization's own aircraft and customer aircraft alike. Owners, admins, dispatchers and technicians only; anybody else is answered 403 for any id. Another organization's aircraft answers exactly as an absent one.

Only name is required. Not given, it went on today (installedOn) at the aircraft's reading now (installedAtMeter, on meter: the tach, or the Hobbs on a Hobbs-only aircraft), new (timeSince) with no time (timeAtInstall: 0). A limit (limitHours in tenths, limitMonths, or both, whichever comes first) is tracked by a linked one-off inspection per clock, due where the limit is reached, so it warns, reminds the owners of a customer aircraft and, with groundAtLimit (default true), grounds the aircraft like any inspection. An aircraft with no meters takes a calendar limit only. Owners, admins and technicians only.

POH, weight and balance, and other files on the tail. Any org member may read bookers files. Staff, dispatchers, and technicians also see staff files. Soft-deleted rows are omitted.

Send fileNames (jpg, jpeg, png, heic, heif, or pdf, up to five in that category). The server writes the S3 keys and returns signedUrlData for the client to POST each file to. fileUrls in the body is refused. Requires owner, admin, dispatcher, or technician. Uploading is turned off in the public demo.

Updates fuel for one or both engines.

Takes a tail off the line, or puts it back. Requires the admin or technician role.

Its own endpoint rather than a field on PATCH /resources/{id}, which is admin-only: a technician signs maintenance off and has to be able to release the aircraft afterwards.

Grounding requires a reason, which is shown wherever the aircraft appears. The reason you send is treated as a PERSON'S decision and is never cleared automatically. Holds the system applies itself (an inspection coming due, an open grounding squawk) are released on their own once nothing is outstanding; yours are not, and stay until someone sends grounded: false here.

Everything done to the aircraft, newest first: inspection sign-offs (including one-time inspections no longer on the active list), resolved squawks, and completed work orders, each with the date, what it was, who signed it off or did it, and the Hobbs and tach at the time in tenths where known. Paged in the database, at most 250 rows a page; pagination.limit is the limit applied. Filter with kind (comma separated: inspection, squawk, work_order); sort=date with order=asc reverses it. Owners, admins, dispatchers and technicians only, answered 403 for any id otherwise; work orders only for owners, admins and technicians.

Every bill tied to the aircraft: for a booking that flew it (flight, prepaid_package), and for a shop job on it (work_order), newest first unless sorted. sort is a dot path into the row (id, createdAt, totalCents, number, status, billedTo.name). Admins only, like every organization-wide invoice list.

Every recorded Hobbs and tach reading (kind: reading, with who, when, a note, a 15-minute photo link, the values it replaced, and workOrder when it was a job's reading in or out) beside the readings close-outs took (kind: close-out, with the booking), newest first, the last 100 of each. All hours are tenths. meterMode says which meters the aircraft has. stale is true for a customer's aircraft with meters not read in over 30 days. Owners, admins, dispatchers and technicians only; anybody else is answered 403 for any id.

Moves the aircraft's own Hobbs and tach and runs the same hour check a close-out does, so hour-based inspections fire as after a flight. Send either meter or both, in tenths; a meter the aircraft does not have (see meterMode) is refused with 400. A reading lower than the aircraft's answers 409 METER_LOWER until sent again with confirmLower: true (a mistyped reading put right: kept as a correction, total time unchanged) or meterReplaced: true (a new meter: the airframe's total time carries on from it; refused with 400 on a reading that is not lower); one that passes an inspection that grounds the aircraft answers 409 MAINTENANCE_TRIGGER with details.triggers until sent with confirmMaintenanceTrigger: true. A reading dated before the newest one on record is kept in the log as history and does not change the aircraft (appliedToAircraft: false). Name a photo with fileName and upload it to the returned signedUrlData. Owners, admins and technicians only.

Who owns this aeroplane: nobody (the organization's own), a leaseback owner, or the customer whose aircraft is in the shop. Ownership decides who is invoiced for maintenance work; it decides nothing about scheduling, which is use. Owners, admins, dispatchers and technicians only, because the rows carry a person's private phone number and email.

Send orgUserId for somebody who is already a member, or name (plus optional email and phone) for an owner the organization has never met. The second form creates a membership for them that is marked external and left unclaimed: they appear on the roster and can be invoiced, they get none of the organization's notifications, and they cannot sign in. An invoice you raise for them IS emailed to email, by Stripe. email must be a real address shape. If somebody already holds that address, the answer is 409 naming them: send their orgUserId to use them, or repeat the request with createAnyway: true if this really is a different person. The same name at the same address is re-used without a 409, which is one customer's second aircraft. When the owner later signs up with a verified address and the same name, joining the organization claims this record rather than creating a second one. Requires the admin role.

What the shop keeps about an aircraft beyond its registration: the airframe's total time (in tenths, as recorded and carried forward by the Hobbs flown since, airframeTotalNowTenths), the engine and propeller, and notes. Empty fields are null; an aircraft nobody has filled in answers all nulls. Owners, admins, dispatchers and technicians only; anybody else is answered 403 for any id.

Send only what changes. airframeTotalTenths is the total time read now; send airframeTotalAtHobbs (tenths) with it when it was read at another Hobbs, otherwise the aircraft's current Hobbs is taken. Null clears a field. Owners, admins and technicians only.

Requires the admin role.

One component, as the list reads it. Owners, admins, dispatchers and technicians only.

Send only what changes; null clears. A changed limit or time MOVES its linked inspections' due point (the same inspections, with the notices the new point has not earned sent again when it is reached; one signed off gets a new open cycle), and releases the aircraft if that was all that held it. removedOn (with removedAtMeter, else the meter now) records that it came off: its time stops there and its inspections are retired, so nothing stays due. removedOn: null puts it back on. Owners, admins and technicians only.

It stops listing and its inspections are retired (signed-off cycles are kept). For a part that came off, record removedOn instead. Owners, admins and technicians only.

Changes label, visibility, or category. Does not replace the bytes. Requires owner, admin, dispatcher, or technician.

Soft-deletes the row and drops the S3 object. A stale W&B should come down. Requires owner, admin, dispatcher, or technician.

Rename their title, or make them the one who gets the invoice. For an owner who has not signed up, you can also correct name, email and phone: these belong to the PERSON, so a correction applies to every aircraft they own and to invoices raised from now on, and the address on their Stripe customer is corrected too. A member's name and contact details are theirs to change from their own profile, and are refused here. An address somebody else already holds is refused, naming them. Requires the admin role.

Removes the link only. The person stays on the roster with their invoices and history intact, because a mistyped name must not be a way to delete a customer. Requires the admin role.

For a photo that never finished uploading: the reading stops pointing at it. Owners, admins and technicians only.