← All action domains

Mobile

3 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.

Request mobile app access

mobile.request_test_accesswriteconfirm

Ask for an email address to be added to a Chirply mobile app's store tester list, and alert the Chirply team that it is waiting. This does NOT install anything or grant access: a person has to type the address into Google Play Console (or App Store Connect) by hand, usually within a day, and the requester is emailed once that happens. The address must be the one the device's store account uses — a Google account for Android, an Apple ID for iPhone — which is often not the address they sign in to Chirply with; the app will not appear for any other account. Submitting the same address again bumps the existing request rather than queueing it twice. Costs nothing.

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.

Also answers to join the beta, add me to the android test, get on the tester list.

Parameters

FieldTypeRequiredDescription
platform"android" | "ios"requiredWhich app: 'android' (Google Play) or 'ios' (the iPhone app, currently available through TestFlight).
emailstringrequiredThe email address on the store account — the Google account the phone's Play Store is signed in to, or the Apple ID. Stored lowercased. Not validated beyond its shape: only the store console can confirm it exists.

Example

curl -X POST https://app.chirply.io/api/v1/actions/mobile.request_test_access \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "android",
    "email": "ada@example.com"
  }'
Test with your API key

Over MCP the same operation is the tool mobile_request_test_access at https://app.chirply.io/api/mcp, same bearer token, same input.

Mobile apps

mobile.statusread

Get Android and iPhone install links, step-by-step installation instructions, release stages and this account's tester requests. Android is a Google Play closed test: open the invitation with an approved Google account, or request access if Play says unavailable. iPhone is a public TestFlight beta: open the invitation on an iPhone, install TestFlight, accept and install Chirply; no email request is needed. Sign in with existing Chirply credentials. Reads only; changes nothing and sends nothing.

Also answers to get the mobile app, android app, iphone app, download the app.

Parameters

FieldTypeRequiredDescription
platform"android" | "ios"optionalOnly report on this app. Omit for both.

Example

curl -X POST https://app.chirply.io/api/v1/actions/mobile.status \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "android"
  }'
Test with your API key

Over MCP the same operation is the tool mobile_status at https://app.chirply.io/api/mcp, same bearer token, same input.

Withdraw mobile app request

mobile.withdraw_test_accesswrite

Take one of this account's tester requests back off the queue, so nobody adds that address to the store's tester list. The record is kept (marked withdrawn) rather than deleted, and the same address can be requested again later. It does not remove anyone the store has ALREADY added — that has to be undone in Play Console or App Store Connect.

Parameters

FieldTypeRequiredDescription
request_idstring (uuid)requiredId of the request to withdraw, from mobile.status.

Example

curl -X POST https://app.chirply.io/api/v1/actions/mobile.withdraw_test_access \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'
Test with your API key

Over MCP the same operation is the tool mobile_withdraw_test_access at https://app.chirply.io/api/mcp, same bearer token, same input.

The machine-readable version of this page is GET https://app.chirply.io/api/v1/actions?domain=mobile — same operations, with full JSON Schemas. Authentication, errors and rate limits are covered in the API documentation home.