5 operations. Call each with POST https://app.chirply.io/api/v1/actions/<name> and a bearer token; the response is { "data": { "action", "summary", "result" } }. A read badge means the operation changes nothing; write requires the credential’s write scope.
Open a PDF under its file name
appdata.create_file_linkwrite
Store a PDF your app generated for a short time (an hour by default, at most a day) and get back a link whose address ENDS IN THE FILE NAME, so the browser's PDF viewer names the tab, its toolbar and its own Download button after your file instead of a random blob id. Only a signed-in member of this account can open the link; it serves nothing to anyone else and expires on its own. PDF only (the bytes must start with %PDF-), up to 25 MB. Costs nothing and sends nothing. In a hosted app use the SDK's `openFile(bytes, name)`, which calls this from a click and opens the viewer tab for you. App-only: a user or API key has no install to own the file and is refused.
Parameters
Field
Type
Required
Description
name
string
required
The file name the link ends in, e.g. "Signing_Instructions_CT_Will.pdf". ".pdf" is added when missing; slashes, quotes, %, # and ? become "_". The final name is returned as `name`.
content_base64
string
required
The PDF's raw bytes, base64-encoded. A `data:` URL prefix and line breaks are accepted. 25 MB decoded at most.
expires_in_minutes
integer
optional
How long the link opens, in minutes: 5 to 1440, default 60. A viewer tab that already loaded the PDF keeps working after it expires.
Over MCP the same operation is the tool appdata_create_file_link at https://app.chirply.io/api/mcp, same bearer token, same input.
Delete app data
appdata.deletewriteconfirm
Delete one value from your app's own data by collection + key.
Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.
Parameters
Field
Type
Required
Description
collection
string
optional
A namespace within your app's storage, e.g. 'settings'. Default: "default"