Approval

​

Quick start

from agno.approval import approval
from agno.tools import tool
from agno.db.sqlite import SqliteDb
from agno.agent import Agent

@approval
@tool(requires_confirmation=True)
def delete_user_data(user_id: str) -> str:
    """Permanently delete all data for a user. Requires admin approval."""
    return f"All data for user {user_id} has been deleted."

db = SqliteDb(db_file="app.db", approvals_table="approvals")
agent = Agent(model=..., tools=[delete_user_data], db=db)

run = agent.run("Delete all data for user U-100")

​

Approval Types

​

Blocking

​

Non-blocking

​

Execution Flow

• The Pause: When a user triggers an @approval tool, the SDK automatically pauses the run and inserts a pending record into your database.
• Admin Approval: Admin views the list of pending requests. Then update the record status via the DB provider. Use expected_status="pending" to prevent race conditions.
  db.update_approval(
      approval_id,
      expected_status="pending",
      status="approved",   # or "rejected"
      resolved_by="admin_user_id",
      resolved_at=int(time.time()),
      # For requires_user_input or external_execution: pass resolution_data
      # (e.g. values for user input, result for external execution); SDK applies it on continue_run.
  )
  
• Resuming the Run: Continue the run using the run_id and session_id. When called without requirements, the SDK verifies the resolution and applies it before proceeding. If the record is missing or still pending, continue_run raises a ValueError.
  run = agent.continue_run(run_id=run.run_id, session_id=run.session_id)
  

​

Examples

​

Developer Resources

• Example code: Approvals cookbook.
• Approval reference
• Tool decorator