complete_action

Mark a visibility action as completed. Use this after you've addressed an action item — created the content, made the outreach, or implemented the technical fix. This keeps the action queue accurate so you know what's left to do.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent ID the action belongs to.
`actionId`	`string`	Yes	The action ID to mark as completed. Get action IDs from `get_visibility_actions`.

Response

{
  "success": true,
  "action": {
    "id": "act-abc123",
    "title": "Write a comparison guide: Example vs CompetitorX",
    "status": "completed",
    "completedAt": "2026-03-20T14:30:00Z"
  }
}

Error: action not found

If the action ID doesn't exist or doesn't belong to the specified agent:

Action act-xyz789 not found for syntheticId=1234.

Parameters

Response

Error: action not found

On this page