| Class | What it does | Recommended approval |
|---|---|---|
| Read | Retrieves information. No data, account state, or permissions change. | Safe to always allow. |
| Write | Creates or changes data in your Conduit workspace. Can be undone or edited afterwards. | Ask on first use; always allow is acceptable. |
| Sensitive write | Sends a message or email to someone outside your team, changes physical access to a property, accepts or declines a guest’s reservation change, books or changes an appointment with a contact, runs or schedules an agent or custom code that can act on its own, or permanently deletes data. | Ask every time. Never always allow. |
readOnlyHint annotation on each tool matches its class: true for Read, false for both write classes. A tool that both reads and writes is classified as a write.
Connection permissions
The OAuth consent screen always lets you choose Read only or Read and write, whatever access the client requested, and the connection gets the level you choose. ChatGPT requests read-only access, so ChatGPT users should choose Read and write to use write tools. A read-only connection can call Read tools only; every write tool returns an error result (isError: true) with code forbidden. API tokens follow the same rule: a read-only capi_ token rejects every write tool.
Search mode
OAuth and API-token connections list two tools,search_tools and call_tool, and reach every tool below through them. The Conduit ChatGPT plugin is the exception: it lists every tool below individually, so approve each tool by its own class.
| Tool | Class |
|---|---|
search_tools | Read |
call_tool | Takes the class of the tool it calls. A client that approves per tool name should treat call_tool as a sensitive write. |
Sensitive write
These tools act on people or property outside Conduit, or cannot be undone.send_conversation_message and send_ticket_message accept an idempotency_key, but most channels do not yet use it to block a duplicate. Do not retry a send that may have succeeded.
| Area | Tools |
|---|---|
| Agents | delete_agent, delete_agent_guardrail, delete_agent_trigger, run_agent |
| Artifacts | artifact_delete |
| Contacts | delete_custom_attribute, merge_contacts, remove_contact_channel |
| Conversation tags | delete_conversation_tag |
| Conversations | send_conversation_message, send_message, send_system_email |
| Custom tools | delete_custom_tool, run_custom_tool |
| Devices | assign_backup_access_code, create_access_code, create_team_access, delete_access_code, revoke_team_access, set_lock_access_hours, set_lock_state, update_access_code, update_team_access |
| Listings | delete_listing_group |
| Operator skills | delete_operator_skill |
| Portals | delete_portal_domain, delete_portal_template, delete_verification_rule, reset_verification_steps, update_portal_settings, waive_verification_steps |
| Reservations and appointments | respond_to_reservation_alteration |
| Schedules | schedule_cron, schedule_wake |
| Skills | delete_skill |
| Tasks | task_automation_delete, task_delete, task_property_remove_template, task_template_delete |
| Tickets | delete_ticket_note, send_ticket_message |
| Voice agents | delete_voice_agent |
Write
| Area | Tools |
|---|---|
| Agents | create_agent, create_agent_trigger, patch_agent, patch_agent_trigger, save_agent_guardrail, set_agent_skill_access, set_agent_tool_access, test_agent |
| Artifacts | artifact_batch, artifact_create, artifact_update |
| Call groups | create_call_group, patch_call_group |
| Contacts | add_contact_channel, contact_update_custom_field, create_contact, create_custom_attribute, create_custom_attribute_section, patch_contact, patch_contact_custom_attributes, patch_custom_attribute, patch_custom_attribute_section |
| Conversation tags | create_conversation_tag, patch_conversation_tag |
| Conversations | assign_conversation, save_note |
| Custom tools | create_custom_tool, update_custom_tool |
| Devices | assign_device_property, set_noise_threshold, set_thermostat |
| Escalations | assign_escalation, resolve_escalation |
| Google Drive | import_drive_file, set_drive_split_mapping |
| Insights | generate_pdf, query_insights |
| Knowledge sources | cancel_knowledge_source_sync, set_knowledge_source_sync |
| Listings | save_listing_group, save_property_team_information, set_listing_active, set_listing_ai, set_listing_owner |
| Operator skills | create_operator_skill, patch_operator_skill |
| Portals | archive_portal_guide, archive_portal_offer, archive_portal_template, create_portal_domain, create_portal_guide, create_portal_listing_upload_url, create_portal_offer, create_portal_template, create_portal_upload_url, create_verification_rule, duplicate_portal_guide, duplicate_portal_template, get_portal, patch_portal_brand_kit, patch_portal_guide, patch_portal_offer, patch_portal_template, patch_verification_rule, refresh_portal_domain, register_portal_listing_upload, register_portal_upload, reorder_portal_guides, reorder_verification_rules, restore_portal_guide, restore_portal_offer, restore_portal_template, save_portal_review_link, unwaive_verification_step, update_portal, update_portal_domain, update_portal_listing_field, update_portal_listing_fields |
| Schedules | schedule_cancel |
| Skills | create_skill, patch_skill |
| Approvals | approval_add_comment, save_approval |
| Tasks | set_owner_reporting_settings, task_add_comment, task_add_requirements, task_attach_image, task_attach_message_media, task_category_create, task_category_update, task_set_estimated_time, task_edit_requirement, task_remove_requirement, task_category_set_roles, task_create, task_finalize_image_upload, task_prepare_image_upload, task_set_assignee, task_set_custom_fields, task_set_due_at, task_set_related, task_set_requirement, task_update, task_update_status, task_automation_create, task_automation_set_enabled, task_automation_update, task_property_apply_template, task_property_create_area, task_property_create_item, task_property_set_category_assignee, task_property_set_checklist_assignee, task_property_set_checklist_estimated_time, task_property_update_checklist, task_recurring_automation_create, task_recurring_automation_set_enabled, task_recurring_automation_update, task_template_create, task_template_create_area, task_template_create_item, task_template_update |
| Tickets | add_ticket_tag, assign_ticket, close_ticket, remove_ticket_tag, reopen_ticket, resolve_ticket, set_ticket_follow_up |
| Uploads | prepare_file_upload |
| Voice agents | create_voice_agent, patch_voice_agent |
| Workflows | apply_workflow_edits, clone_workflow, create_workflow, create_workflow_folder, move_workflow_to_folder, update_workflow |
| Workspaces | create_workspace_role, invite_workspace_member, set_member_work_hours |
Read
| Area | Tools |
|---|---|
| Agent runs | get_agent_run, get_agent_runs_by_session_id, get_agent_trace, list_agent_runs, list_agent_sessions |
| Agent triggers | get_trigger_event |
| Agents | get_agent, list_agent_connections, list_agent_guardrails, list_agent_tools, list_agent_triggers, list_agents, list_supported_models |
| Analytics | describe_bigquery_tables, execute_bigquery_query |
| Artifacts | artifact_guide, artifact_query, artifact_read |
| Billing | get_billing_usage |
| Calls | get_call, list_airbnb_transactions, list_calls |
| Contacts | contact_list_custom_fields, get_contact, get_contact_allocation, get_contact_custom_attributes, list_contact_appointments, list_contact_calls, list_contact_helpdesk_tickets, list_contact_reservations, list_contact_tickets, list_contacts, list_custom_attribute_sections, list_custom_attributes, search_contacts |
| Conversation tags | get_conversation_tag, list_conversation_tags |
| Conversations | get_channels_for_contact, get_conversation, get_message_templates, list_conversation_assignment_events, list_message_senders, list_notes, search_conversations |
| Custom tools | get_custom_tool, list_custom_tool_runtimes, list_custom_tools |
| Devices | get_access_code, get_device_history, get_device_telemetry, get_team_access, list_access_codes, list_devices, list_team_access |
| Escalations | list_escalations |
| Google Drive | get_drive_file, list_drive_connections, list_drive_files, propose_drive_split_mapping, search_drive_files |
| Helpdesk | get_helpdesk_ticket, list_helpdesk_tickets |
| Insights | get_automation_rate, get_resolution_rate |
| Knowledge sources | list_knowledge_sources |
| Approvals | get_approval, list_approvals |
| Listings | check_listing_availability, get_listing, get_listing_group, get_property_team_information, list_listing_cities, list_listing_groups, list_listings, search_listing_availability |
| Local recommendations | get_directions, google_places_recommendations |
| Operator skills | list_operator_skills |
| Portals | get_checkin_status, get_customer_portals, get_portal_brand_kit, get_portal_guide, get_portal_listing_fields, get_portal_offer, get_portal_session, get_portal_settings, get_portal_template, get_verification_rule, list_portal_domains, list_portal_guides, list_portal_listing_fields, list_portal_offer_catalog, list_portal_offers, list_portal_orders, list_portal_reviews, list_portal_sessions, list_portal_template_catalog, list_portal_transactions, list_portal_waiver_payments, list_verification_rules |
| Reservations and appointments | get_appointment, get_reservation, list_appointments, list_reservation_alterations, list_reservations, present_booking_checkout |
| Reviews | get_ota_review_metrics |
| Schedules | schedule_list |
| Skills | get_skill, list_skills |
| Tasks | get_owner_reporting_settings, find_nearby_workers, task_category_get, task_get, task_list, task_list_categories, task_list_custom_fields, task_list_statuses, task_resolve_send_target, task_automation_list, task_property_list_category_assignees, task_property_list_checklists, task_template_list, task_template_list_areas, task_template_list_items |
| Tickets | get_ticket, get_ticket_detail, list_ticket_events, list_tickets, search_tickets |
| Voice agents | get_voice_agent, list_voice_agents |
| Workflows | get_workflow, get_workflow_outline, get_workflow_resource_references, get_workflow_schema, get_workflow_step, get_workflow_step_references, get_workflow_step_schema, list_workflow_execution_events, list_workflow_executions, list_workflow_folders, list_workflows, preview_workflow_clone, preview_workflow_edits |
| Workspaces | get_member_work_hours, list_inbox_types, list_inboxes, list_workspace_permissions, list_workspace_roles, list_workspace_senders, list_workspace_users, list_workspace_whatsapp_templates, list_workspaces, search_workspace_users |
Knowledge, booking, and web tools
These tools come from Conduit’s knowledge service and appear insearch_tools alongside the tools above.
| Class | Tools |
|---|---|
| Sensitive write | book_appointment, cancel_appointment, confirm_booking, delete_knowledge, delete_source, reschedule_appointment |
| Write | bulk_set_knowledge_scope, create_booking_link, create_directory, create_knowledge, edit_knowledge, ingest_file, ingest_link, ingest_structured, move_directory_contents, move_knowledge, rename_directory, set_knowledge_scope |
| Read | find_similar_pages, get_appointments, get_booking_calendar_availability, get_knowledge, get_knowledge_scope_job, get_schedule, health_check, knowledge_search, semantic_knowledge_search, web_answer, web_search |