Casa

Completed Requests or completed handyman tasks for the home, newest first, optionally between two dates in the home's time zone (ISO 8601 dates or datetimes). Defaults to 25 results, up to 100. Takes a home_id from list_homes.

check_completed_work

What the member can book with a handyman: the tasks ready to book with how long each takes, the upcoming handyman visits they can still change, with their items, time, and handyman, and the handyman credit balance and hourly rate past it. Takes a home_id from list_homes.

check_handyman_booking

A compact index of the home's inventory: its structure, rooms, categories, and items, with room_id, category_id, and entity_id handles for open_inventory_item. Takes a home_id from list_homes.

check_inventory

The home's invoices from vendors and Casa's services, with amount, date, and whether each is paid. Takes a home_id from list_homes.

check_invoices

The home's Casa membership: plan, price and billing interval, billing dates, handyman terms and credits, benefits, and savings. Takes a home_id from list_homes.

check_membership

The home's incoming and outgoing packages with carrier, status, tracking, and delivery estimates, plus the pickup services for returns and donations. Archived packages are included only when asked for. Takes a home_id from list_homes.

check_packages

The home's property tax records from public sources: assessed and taxable values, the tax collector, bills, installments, and special assessments. Informational, not tax advice. Takes a home_id from list_homes.

check_property_taxes

Things Casa buys for the home, grouped as needing the member's approval, processing, or complete, optionally for one Request or one visit (not both). Takes a home_id from list_homes.

check_purchases

The home's recurring vendors for cleaning, gardening, pool, and pest control: who, their schedule, the next visit, and anything waiting on the member. Takes a home_id from list_homes.

check_recurring_vendors

Work Casa's Concierge team suggests for the home from what it has learned about it, as the Casa app lists it, with suggested_todo_id handles for accept_suggested_todos. A suggestion isn't on the member's To-Do list until it's accepted. Takes a home_id from list_homes.

check_suggested_todos

The home's Casa Mailbox, newest first: each piece's mail_item_id, sender, received date, whether it's read, Casa's summary, and notes such as a check enclosed. Pass archived for archived mail. Takes a home_id from list_homes.

check_mail

The home's connected utilities: providers, account readiness, trash pickup days, the latest statement, recent statements, and usage over time. Takes a home_id from list_homes.

check_utilities

Deletes To-Do’s and ready-to-book Handyman tasks from the member’s list, as deleting them in the Casa app does: any of the member’s, not only yours, but never one already sent, booked on a visit, or that Casa’s team made. A deleted one can’t come back, so only delete what the member asked you to; check_requests_and_todos lists them with their IDs. An app can dismiss and delete 30 a day, together. Takes a home_id from list_homes.

delete_todos

Dismisses Casa’s suggested To-Do’s the member doesn’t want, as Already handled or Dismiss does in the Casa app; check_suggested_todos lists them with their IDs. A dismissed suggestion can’t come back, so only dismiss what the member asked you to. An app can dismiss and delete 30 a day, together. Takes a home_id from list_homes.

dismiss_suggested_todos

Changes the title or description of a To-Do the member hasn't sent yet, as editing it in the Casa app does. Casa doesn't ask its questions again. A To-Do Casa is still preparing can change once it's done; one already sent can't change. The same title and description again change nothing. An app can answer and edit To-Do's 60 times a day. Takes a home_id from list_homes.

edit_todo

When a handyman visit could happen for a set of ready-to-book tasks: upcoming visits that could take them and new start times, or, for an existing visit, whether it can move and whether the same handyman stays. Every option carries the start_at and task IDs book_visit and update_visit take; times aren’t held until booked. Takes a home_id from list_homes.

find_visit_times

Lists the member's Casa homes this app may read: each home's home_id, full address, plan (plus or premium, or null for a membership Casa can't name), whether the member is the home's primary member, and a link that opens the home in the Casa app.

list_homes

Marks pieces of mail read or unread, archives them, or brings them back to the Mailbox, as the Casa app does. The change is the whole household’s: marking a piece read clears it from everyone’s unread count. Only what the member asked for. An app can make 200 of these changes a day. Takes a home_id from list_homes.

update_mail

Sends a message to Casa’s Concierge team on one of the member’s Requests, shown in the Request chat as the member’s message, marked with your name. Use it to pass on what the member wants Casa to know: an answer to Casa’s question, a time that works, a detail the team needs. Only what the member asked you to send, in their voice; never access codes, passwords, or payment details. As the member’s own message in the app does, it reopens a finished Request for the team and marks Casa’s replies read. The same text on the same Request within 10 minutes returns the message already sent. An app can send 20 messages a day. Takes a home_id from list_homes.

send_request_message

One Request in detail: its state, visits, invoices, purchases, feedback prompts, and the latest messages between the member and Casa. Older messages are left out when the history is long. Takes a home_id from list_homes.

open_request

One To-Do from the member's list: its description, status, the rooms and items it's about, what it asked the member for with their answers, its files, and the handyman task or Request it became. With wait_for_questions, waits up to 30 seconds while Casa is still preparing it, then returns it with what Casa asks: use it after add_todos, accept_suggested_todos, or answer_todo_questions says Casa is thinking. Takes a home_id from list_homes.

open_todo

One handyman task: its status, description, updates, files, the visit it's booked on, and what the member can do with it in the Casa app. Takes a home_id from list_homes.

open_handyman_task

One package with its latest tracking events. Takes a home_id from list_homes.

open_package

One piece of mail: who it's from and to, when it arrived, Casa's summary, and the text of its scan, with the scan, any check, and the envelope as files. Opening it doesn't mark it read; update_mail does. Takes a home_id from list_homes.

open_mail

One purchase: its state, item, retailer, quantity, prices, shipping, returns, and the Request or invoice it belongs to. Takes a home_id from list_homes.

open_purchase

One recurring vendor: schedule, how they're paid, upcoming and recent visits, and recent invoices with line items. Takes a home_id from list_homes.

open_recurring_vendor

One utility statement: provider, billing period, due date, total, usage, and charges. The account number stays hidden. Takes a home_id from list_homes.

open_utility_statement

One vendor visit: when it's booked, its Request, the vendors coming, the handyman tasks and Autopilot items on it, invoices, purchases, feedback prompts, and what the member can change in the Casa app. Takes a home_id from list_homes.

open_visit

One Autopilot plan: what it covers, cadence options, upcoming and requested dates, savings, and its policies. Takes a home_id from list_homes.

open_autopilot_plan

One room, category, room and category together, or tracked item from the home's inventory: make and model, rooms, manuals, components, properties, service plans, and service history. Pass the IDs the target type needs. Takes a home_id from list_homes.

open_inventory_item

One invoice: vendor, amount, payment state, line items, the vendor's reference and due date, attachments, and the Request or visit it belongs to. Takes a home_id from list_homes.

open_invoice

Rates finished work for the member: answers the feedback Casa asks for on a Request, by the numbers open_request’s Feedback lists, with the member’s own rating, reasons, and words. Each question can be answered once, so only rate what the member told you. Casa’s team reads the rating and note as the member’s, given through you. Takes a home_id from list_homes.

rate_request

The full text of up to five Help Center articles, by article ID. Takes a home_id from list_homes.

read_help_articles

The photos and PDFs on one To-Do, handyman task, or Request, or an inventory item's manuals: photos come back as images, and each PDF as a link the app can read. Up to five files a call, in order; pass attachment_ids to pick others. Takes a home_id from list_homes.

read_files

Answers Casa’s team when they ask on a Request when the member is free (open_request shows the availability request), with every window the member gave, in the home’s time zone, as Share availability does in the Casa app. Casa’s team books a visit within them and tells the member. The windows replace any shared before, and the member can change them in the app. Only times the member gave you, or asked you to take from their own calendar. Takes a home_id from list_homes.

share_availability

Puts one question for Casa's Concierge team on the member's list, under Send to Concierge, for the member to send from the Casa app. Use when the member wants a person at Casa on something: their account, billing, membership, Casa's policies, or a Casa service or visit. Nothing reaches the Concierge team until the member sends it. The same text again within 10 minutes returns the question already staged. Counts toward the 30 To-Do's an app can add a day. Takes a home_id from list_homes.

add_support_question

Tracks a package for the member in their Casa Packages, as Track package does in the Casa app: Casa finds the carrier from the number, follows the delivery, and notifies the household when it arrives. Use when the member shares a tracking number or a shipping confirmation. A number the home already tracks returns that package. An app can track 10 packages a day. Takes a home_id from list_homes.

track_package