> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions reference

> Every action type the Co-founder can propose, what approving it changes, whether it can run automatically and how to undo it.

An **action** is one exact change the Co-founder prepared for you. This page lists every action type. For how the queue, approvals and automation work, see [Actions and approvals](https://docs.appeeky.com/docs/cofounder/actions-and-approvals.md).

The **Type** column is the value you see in the API (`action_type`), in **Settings → Automation → Policy rules** and in `autoApproveTypes`.

***

## Summary

"Automatic" means the action can run without your approval. This is only possible in **write** mode. In **read** mode every action waits for you.

| Action | Type | Needs | Automatic |
| - | - | - | - |
| App Store metadata update | `asc_metadata_update` | App Store Connect | From autopilot level 3, or with auto-approve |
| Review reply | `asc_review_reply` | App Store Connect | Only with auto-approve |
| New App Store version | `asc_version_create` | App Store Connect | From autopilot level 3, or with auto-approve |
| Google Play listing update | `google_play_metadata_update` | Google Play Console | Not by autopilot level. Only if you add the type to `autoApproveTypes` through the [API](https://docs.appeeky.com/docs/cofounder/api.md#preference-fields). |
| Linear issue | `linear_issue` | Linear | From autopilot level 2, or with auto-approve |
| GitHub issue | `github_issue` | GitHub | From autopilot level 2, or with auto-approve |
| Notion page | `notion_page` | Notion with a database selected | From autopilot level 2, or with auto-approve |
| Webhook post | `webhook_post` | Webhook | From autopilot level 2, or with auto-approve |
| Coding agent task | `engineering_delegate` | Cursor, Hermes Agent or OpenClaw | Not by autopilot level. Only if you add the type to `autoApproveTypes` through the API. |
| Apple Ads campaign change | `asa_campaign_update` | Apple Ads | Never |
| Apple Ads keyword bid | `asa_keyword_bid_update` | Apple Ads | Never |
| Apple Ads negative keywords | `asa_add_negative_keywords` | Apple Ads | Never |
| Meta Ads campaign change | `meta_campaign_update` | Meta Ads | Never |
| TikTok Ads campaign change | `tiktok_campaign_update` | TikTok Ads | Never |
| Monetization change | `revenuecat_experiment` | RevenueCat | Never |
| Win-back campaign | `lifecycle_campaign` | Nothing (uses your account email) | Never |
| UGC clip | `ugc_clip` | A UGC persona | Never |
| Social comment reply | `social_comment_reply` | Connected social accounts | Never |

> [!NOTE]
>
> A metadata update that would drop a search term you rank in the top 20 for is never applied automatically, at any autopilot level. A policy rule set to **Require approval** also overrides every "automatic" case above.

***

## Store

### App Store metadata update

`asc_metadata_update`

| | |
| - | - |
| **Changes** | One field for one locale in App Store Connect: `subtitle`, `keywords`, `description`, `promotional_text` or `whats_new`. The subtitle is saved on the app information. The other fields are saved on your editable version. |
| **Limits** | Subtitle 30 characters, keywords 100, promotional text 170, description and What's New 4,000. A value over the limit is rejected. |
| **Card shows** | Current value, proposed value, the reason, the locale, and any top-20 search terms the change would drop |
| **Undo** | The value that was replaced is kept on the action. If the change loses on its metric after 14 days, or its top-20 terms fall, the Co-founder queues a revert action with the old value. You can also ask in chat: "put the old subtitle back". |
| **If the live write fails** | The change is saved as a draft in **My Apps** so you can publish it yourself |

### Review reply

`asc_review_reply`

| | |
| - | - |
| **Changes** | Posts your developer response to one App Store review |
| **Card shows** | The review title and rating, the proposed reply, and its tone (empathetic, appreciative, informative or apologetic) |
| **Undo** | A reply can be edited: approving a new reply for the same review replaces the earlier one |

The Co-founder only proposes replies for real, unanswered reviews. A proposal for a review that was already answered is dropped before it reaches your queue.

### New App Store version

`asc_version_create`

| | |
| - | - |
| **Changes** | Creates an empty new version in App Store Connect, optionally with What's New text for the primary locale |
| **Does not** | Attach a build, submit for review or release anything |
| **Undo** | Delete the version in App Store Connect |

### Google Play listing update

`google_play_metadata_update`

| | |
| - | - |
| **Changes** | One field for one language of your Play store listing: `title` (30 characters), `short_description` (80) or `full_description` (4,000) |
| **Note** | The change is published to your listing directly. Google Play has no experiment step in between. |
| **Undo** | Same as App Store metadata: the old value is kept and a revert action is proposed when the change hurt |

***

## Team tools

### Linear issue and GitHub issue

`linear_issue`, `github_issue`

| | |
| - | - |
| **Changes** | Opens one issue with a title, description, priority and labels. Linear issues go to your default team unless the Co-founder picks another. GitHub issues go to the repository you chose for the app. |
| **Undo** | Close or delete the issue in that tool |

### Notion page

`notion_page`

| | |
| - | - |
| **Changes** | Creates one page in the Notion database you selected |
| **Requires** | A database picked in **Integrations → Notion**. Until one is selected these actions are not created. |

### Webhook post

`webhook_post`

| | |
| - | - |
| **Changes** | Sends one event with a name and a summary to your webhook URL |
| **Undo** | Nothing to undo in Appeeky. What happens next depends on your receiver. |

### Coding agent task

`engineering_delegate`

| | |
| - | - |
| **Changes** | Sends a task brief to your connected coding agent, with the feature gap, the evidence, the target repository and guardrails. Your agent does the work and opens a pull request. |
| **Limits** | Up to 10 tasks a day and 3 running at the same time |
| **Track** | The action shows the run status. See [Coding agents](https://docs.appeeky.com/docs/cofounder/coding-agents.md). |
| **Undo** | Close the pull request |

***

## Ads

All ads actions always need your approval.

### Apple Ads campaign change

`asa_campaign_update`

| | |
| - | - |
| **Changes** | Pauses or enables one campaign, or sets its daily budget |
| **Undo** | Approve the opposite change, or ask in chat: "re-enable that campaign" |

### Apple Ads keyword bid

`asa_keyword_bid_update`

| | |
| - | - |
| **Changes** | Sets a new bid on one keyword in one ad group |
| **Card shows** | The keyword, the current bid and the proposed bid |
| **Undo** | Set the earlier bid again |

### Apple Ads negative keywords

`asa_add_negative_keywords`

| | |
| - | - |
| **Changes** | Adds up to 20 negative keywords (exact or broad match) to one campaign |
| **Note** | Apple's "Unknown search term" bucket cannot be added as a negative keyword and is skipped |
| **Undo** | Remove the negative keywords in Apple Ads |

### Meta Ads campaign change

`meta_campaign_update`

| | |
| - | - |
| **Changes** | Pauses or enables one campaign or ad set, or sets its daily budget |
| **Scope** | Only campaigns that promote this app. Campaigns for your other products in the same ad account are not touched. |
| **Undo** | Approve the opposite change |

### TikTok Ads campaign change

`tiktok_campaign_update`

| | |
| - | - |
| **Changes** | Enables or disables one campaign, or sets its budget in your advertiser currency |
| **Undo** | Approve the opposite change |

***

## Revenue and retention

### Monetization change

`revenuecat_experiment`

| | |
| - | - |
| **Changes** | Makes one RevenueCat offering the current offering for your project, for example to roll out the winner of an experiment you ran in RevenueCat |
| **Does not** | Create experiments or change prices |
| **Undo** | Make the previous offering current again. The card shows which one it was. |

### Win-back campaign

`lifecycle_campaign`

| | |
| - | - |
| **Changes** | Emails **you** a ready-to-run plan: the segment, a subject line, draft copy and a suggested offer |
| **Does not** | Contact your users. You send the campaign with your own tools. |

***

## Content and social

### UGC clip

`ugc_clip`

| | |
| - | - |
| **Changes** | Starts rendering a short video with one of your personas, from a script, a scene and a caption. This uses media credits. |
| **After** | The finished clip appears in **UGC Creators** and needs a second approval there before it can be scheduled. Nothing is posted by this action. |

### Social comment reply

`social_comment_reply`

| | |
| - | - |
| **Changes** | Posts a reply to one comment on one of your social posts |
| **Checks** | The comment still exists, is not your own and has no reply yet |
| **Undo** | Delete the reply on that platform |

***

## Automatic retries

When you approve an action and applying it fails, it stays in **Approved**. Some types are retried for you, about once an hour, up to three attempts in total and for up to 14 days:

* Review reply
* Apple Ads campaign change, keyword bid and negative keywords
* Linear issue, GitHub issue, Notion page

Other types are never retried automatically, because a second attempt could do harm: metadata updates, new versions and coding agent tasks. Use **Retry** on the card for those.

A failure that needs you is never retried: a disconnected integration, a missing permission, an expired token or a missing repository. Fix the connection in **Integrations**, then retry.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.