Ploy

List a bounded page of Ploys in the authorized workspace. Returns metadata and nextCursor for continuation.

ploy_list

List enriched visitors for a site in the authorized workspace without an agent turn. Returns identified people and companies, excluding anonymous traffic, raw IPs, and vendor payloads. Pages are ordered by identification time; nextOffset continues with the same filters. Pages can shift during enrichment.

ploy_visitors

List document IDs, titles, and paths in the authorized workspace, newest updated first. Optional search matches document titles. nextOffset continues with the same search; read content with ploy_document. Pages can shift as documents are added, edited, or deleted.

ploy_documents

List site IDs and titles in the authorized workspace, with optional title search. Use a returned site ID for visitors, site status, and form submissions. nextOffset continues with the same filters.

ploy_sites

add: send columns as an array of {label, type, config?} to create all names and types together and return columns in input order. The table may have at most 97 fields including existing fields and title. Single label/type/config is also supported in one call; no separate rename or retype is needed. Batch schema jobs run sequentially; on failure refresh the schema and add only missing columns; delete: remove field and its values; rename: change label, retaining fieldId and secret protection; retype: convert existing values, retaining applicable configuration, and fail if conversion is blocked; secret: mark a column secret, preserving explicit human settings. Agents cannot unmask columns. Read ploydb_columns first. LONG_TEXT is Markdown rich text, suitable for fancy descriptions. RELATION only references rows in this same table; cross-table targets are rejected. Primary title stays TEXT. Managed columns and prompt invariants remain enforced by the domain service.

ploydb_column

create: create an empty database with displayName; delete: archive a database by ploydbId, owner/admin only; rename: change displayName while retaining identity and table data. Database creation does not create a table.

ploydb_database

add: supply rows (an array of up to 100 field-ID-keyed value objects) and idempotencyKey to create a batch and return rows in input order. Retain the key and unchanged data/order on retry; inserted counts newly created rows, while rows includes existing records on retry. Single values remains supported without a key; update: patch supplied values by rowId, null clears a cell; delete: remove row by rowId. Read schema and current rows first. For LONG_TEXT rich text, send a Markdown string with headings, emphasis, lists, or links; do not send HTML or an editor JSON document. Pass expectedVersion for updates to detect concurrent edits. Secret and managed-column writes are refused. Updates return the saved row with secrets masked; use labels when presenting it. After an unknown add result, inspect rows before retrying to avoid duplicates.

ploydb_row

create: supply name, optional titleColumnName (default Name), and optional columns with label/type/config to create the schema in one call. columns are additional to the required TEXT title, at most 97 total; explicit columns omit starter content. skipStarterContent=true creates only the title when columns are omitted, without blank rows or generic Property columns; delete: remove table and all rows; rename: change name without changing its ID; duplicate: start a durable copy of schema and rows using operationKey. Duplicate returns a receipt, not completion; poll ploydb_operation. Reuse the same operationKey on duplicate retries. Read tables before mutation; deletes lose data.

ploydb_table

Set a Ploy's read timestamp to the current time and return confirmation. Repeated calls advance the timestamp.

ploy_mark_read

Publish the current saved site to production without an agent turn. Requires site-publish and data-read permissions and a siteId from ploy_sites or a site artifact. Returns a durable operationId, not completion; poll ploy_site_publish_status. Retain the idempotencyKey when retrying this publish; use a new key for a new publish. Does not change automatic agent-publish permission.

ploy_site_publish

Read one bounded page of rows or CSV. filters are ANDed {field: fieldId, op, value}; sort is [{field: fieldId, dir: asc|desc}]. Use each column's filterOperators: eq/neq exact values, contains text substring, gt/gte/lt/lte ordered values, list_contains/list_not_contains one list member, is_null/is_not_null without value. CHECKBOX writes and filters accept booleans, but returned cells use 1/0; DATE accepts YYYY-MM-DD; SELECT/STATUS use option IDs; list members use option/person/row IDs for their type. search matches non-secret searchable columns. Secret columns allow only presence filters, no sort. Continue nextCursor with identical filters/sort/search; concurrent changes can shift pages. values remain field-ID-keyed: present column labels to the user. CSV exports a page with labeled headers, masked secrets, and continuation metadata, not a complete snapshot.

ploydb_rows

Read one bounded page of public conversation events and current activity. Returns nextCursor even on empty pages, hasMore for pagination, and dashboardUrl for browser handoffs.

ploy_read

Read a table's columns, immutable field IDs, labels, types, configuration, secret status, and per-column filterOperators. Load before querying or editing rows. User-facing tables must use labels as headers; keep IDs for tool arguments only.

ploydb_columns

Read one Ploy artifact's available public content and references. Inline content over 256 KiB is omitted with contentOmitted: true. Returns dashboardUrl for the full artifact or editing.

ploy_artifact

Read Markdown by documentId or exact path in the authorized workspace, up to 10,000 UTF-16 code units per page. Continue at nextOffset with the returned updatedAt version; a changed version returns an error so reading can restart. Does not edit the document.

ploy_document

List captured form submissions for a site, newest first. Supports form name/page URL and date filters. Metadata only by default; includeData returns submitted field values without collected IP addresses or user agents. nextOffset continues with the same filters. Pages can shift as submissions are added or deleted.

ploy_form_submissions

Read a production publish operation using its siteId and operationId. Returns in_progress, succeeded, or failed with deployment statuses and URLs. Poll at intervals of at least two seconds while in_progress. Failure details are available at dashboardUrl. Does not start a publish or an agent turn.

ploy_site_publish_status

Recover interrupted or stalled work in a Ploy. Returns an accepted run and starting sequence, or log_quiet when there is no recoverable work. May resume agent actions and consume credits.

ploy_recover

Rename a Ploy and return its updated metadata.

ploy_update

Continue an existing Ploy by queuing a message or steering an eligible running turn. Returns a durable receipt; the idempotencyKey deduplicates retries of the same message.

ploy_send

Create a Ploy and submit its first message to the agent. Returns a durable receipt while work continues. Retries with the same idempotencyKey do not create another Ploy or message.

ploy_start

Stop active or queued work in a Ploy. Returns the stop state and whether a durable stop was recorded.

ploy_stop

Upload a private attachment from canonical base64 bytes, up to 10 MiB. Returns a confirmed fileId for a later start, message, or answer. No existing Ploy or artifact is required; uploading alone does not send a message.

ploy_upload