Skip to main content

Introduction

The Activity Inbox is your central queue for handling requests from agents that need human input. When an agent reaches a point where it requires your approval or needs you to answer a question, it sends a request to the Activity Inbox. You can review, respond to, and manage all of these requests in one place.

Key Concepts

Request types:
  • Approval — The agent needs you to confirm or reject a decision before it can proceed.
  • Question — The agent needs you to provide an answer or additional information.
Statuses:
  • Pending — The request is waiting for your response. Your agent is paused until you act.
  • Answered — You have responded and the agent has continued.

Where to Find It

The Activity Inbox is located in the left sidebar under your workspace. A badge on the icon shows the number of pending requests so you can see at a glance when agents need your attention.

Viewing Requests

The inbox lists all requests with their title, description, the agent that sent them, the request type, and a timestamp. Use the filters at the top to narrow the view:
  • By status — Show only Pending or Answered requests
  • By type — Show only Approval or Question requests
Click on any request to open a detail panel on the right side of the screen, which shows the full context of the agent run that generated the request. The header of the detail panel displays the agent name as a link — click it to navigate directly to the specific Run that sent the request.

Responding to Requests

To respond to a pending request:
  1. Click on the request to open the detail panel.
  2. Type your response in the text field.
  3. Submit your answer. The agent will resume with your input.
You can also mark a request as responded without providing a text reply if the agent no longer needs the input.

Bulk Actions

When managing a large number of requests, use the bulk actions available at the top of the inbox:
  • Mark all as responded — Clears all pending requests at once.
  • Delete all responded — Removes answered requests from the list.
  • Delete all — Clears the entire inbox.

Real-Time Notifications

The Activity Inbox updates in real time. When a new request arrives:
  • A toast notification appears on screen.
  • The sidebar badge counter increments.
You do not need to refresh the page to see new requests.

API Webhook Status

For agent runs triggered via the API, the Activity Inbox shows the webhook delivery status alongside the request details. This lets you verify whether external systems were notified when a request was created or resolved.