Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,8 @@ Use only paths and payload fields confirmed by discovery and the live schema:
| Update/delete a record | update_entity/delete_entity on the exact returned record path |
| Delete a table | delete_entity on the exact discovered table path, only when supported and the user confirmed deletion of the whole table, not a record |
| Create/update/delete a business skill | Matching entity tool on the discovered skills collection or concrete skill path |
| App operation | do_action on the exact returned app-scoped operation; use prepare_* then submit_* only when exposed |
| App record operation | do_action on the exact returned `.../apps/{appName}/tables/{tableName}/operations/{operationName}` path; use prepare_* then submit_* only when exposed |
| App custom operation | do_action on the exact `.../apps/{appName}/operations/{operationName}` path returned by get_schema on the app, with its schema-defined inputs in jsonBody |
| Custom API or in-app MCP operation | do_action on the discovered concrete API/tool path with schema-defined inputs |
| Upload a record file | do_action on the discovered `.../records/{recordId}/files/{columnName}/upload` path |

Expand Down
11 changes: 7 additions & 4 deletions plugins/workiq/skills/workiq/references/business-applications.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ Use the following inherited shapes only after discovery confirms the resource:
| Inspect tables | fetch or get_schema on `/businessapps/environments/{environmentId}/tables/{tableName}` |
| Read a record | fetch `/businessapps/environments/{environmentId}/tables/{tableName}/records/{recordId}` |
| Inspect an app | fetch `/businessapps/environments/{environmentId}/apps/{appName}` |
| List an app's custom operations | get_schema on `/businessapps/environments/{environmentId}/apps/{appName}`; its app-level operations are the app's custom operations |
| List/read an environment business skill | fetch `/businessapps/environments/{environmentId}/skills` or its returned skill path |
| Query environment data | do_action `/businessapps/environments/{environmentId}/query`, with schema-defined `{"querytext":"{supportedReadQuery}"}` |
| Download a record file | call_function on the discovered `.../records/{recordId}/files/{columnName}/download` path |
Expand All @@ -42,10 +43,12 @@ query is read-only and supported; do not generate a write query under a read
request. Use optional destinationPath only when supported. Record-file download
does not establish a Graph fetch_blob or OneDrive upload contract.

App operations omit `/records/`: use exact returned paths under
`.../apps/{appName}/tables/{tableName}`. If the schema exposes a read-only `view`
or `read` action, use its supported arguments; never construct an app operation
from an environment record path.
App operations omit `/records/` and exist at two levels: table-level record
operations under `.../apps/{appName}/tables/{tableName}`, and app-level custom
operations a maker added to the app under `.../apps/{appName}/operations/`.
Use only exact paths and operation names returned by get_schema. If the schema
exposes a read-only `view` or `read` action, use its supported arguments; never
construct an app operation from an environment record path.

## Results and stopping

Expand Down