Skip to main content

Activating actions

Actions discovered by the crawler start in review state. They are not offered to visitors until you activate them.

Before you start​

  • A bot that has completed its first crawl (status: ready)
  • At least one discovered action in review state (check with GET /api/bots/{botId}/actions)

Steps​

  1. List pending actions:

    curl "https://api.mimicbot.app/api/bots/{botId}/actions?status=review" \
      -H "Authorization: Bearer $MIMICBOT_TOKEN"

  2. Review the target and paramsSchema of each action. Confirm the selector, fieldMap, and pageUrl look correct.

  3. Activate an action you trust:

    curl -X PATCH https://api.mimicbot.app/api/bots/{botId}/actions/{actionId} \
      -H "Authorization: Bearer $MIMICBOT_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{ "status": "active" }'

  4. Drop an action that's incorrect (e.g., the crawler picked up a footer form you don't want the bot proposing):

    curl -X PATCH https://api.mimicbot.app/api/bots/{botId}/actions/{actionId} \
      -H "Authorization: Bearer $MIMICBOT_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{ "status": "dropped" }'

What you just did​

  • Approved one or more discovered actions
  • Removed bad-match actions from the review queue
  • Started offering actions to visitors

Next​

→ Execution history