Content Research Agents

Turn autopilot on or off for an agent

Turn autopilot on or off. Same switch as autopilot on PUT /v1/agents/:id. Autopilot is on by default and needs no unlock; it never removes a keyword or exclude term you set. autonomy_level ("autopilot" / "suggest") is the older spelling and is still accepted. cognition_enabled=false pauses self-optimization entirely. Free.

put/v1/agents/{id}/autonomy

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/agents/{id}/autonomy
  • Auth: HTTP bearer

Path parameters

idstring required

Agent UUID

Request body

autopilotboolean

true turns autopilot on (the default for every agent); false keeps the configuration exactly as you set it.

autonomy_level'suggest' | 'autopilot'

Older spelling of autopilot: "autopilot" = on, "suggest" = off. Send one of the two, not both.

cognition_enabledboolean

Master switch for self-optimization. false pauses all reflection and changes; true resumes.

Response

Autonomy updated

messagestring required

Example response

{
  "data": {
    "keywords": [
      "protein recipes",
      "meal prep"
    ],
    "platforms": [
      "tiktok",
      "youtube",
      "instagram"
    ],
    "intent_keywords": [
      "high protein recipe",
      "protein meal prep",
      "protein dessert"
    ],
    "pinned_keywords": [
      "protein recipe",
      "highprotein"
    ],
    "latest_run": {
      "keyword_breakdown": [
        {
          "keyword": "high protein recipe",
          "videos_inserted": 41,
          "videos_updated": 12,
          "tiktok_count": 27,
          "youtube_count": 12,
          "instagram_count": 2
        }
      ]
    }
  },
  "message": "Autonomy updated"
}

Changes

No recorded changes to this operation across all 1 revision of this API.