sealgate-ai Web Agent Sessions API
The Web Agent Sessions API from sealgate-ai — 2 operation(s) for web agent sessions.
The Web Agent Sessions API from sealgate-ai — 2 operation(s) for web agent sessions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sealgate-ai:sealgate-ai-web-agent-sessions-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SealGate Web Agent Sessions API
description: Open-source MCP security, aggregation, and monitoring. Self-hosted MCP proxy.
version: 0.19.0
tags:
- name: Web Agent Sessions
paths:
/api/v1/web-agent-sessions:
get:
summary: List Web Agent Sessions
description: List web-agent sessions visible to the caller, latest activity first.
operationId: list_web_agent_sessions_api_v1_web_agent_sessions_get
security:
- HTTPBearer: []
parameters:
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
description: Page number
default: 1
title: Page
description: Page number
- name: per_page
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Items per page
default: 50
title: Per Page
description: Items per page
- name: agent
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by web agent, e.g. chatgpt
title: Agent
description: Filter by web agent, e.g. chatgpt
- name: user_email
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by user email(s), comma-separated
title: User Email
description: Filter by user email(s), comma-separated
- name: q
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 200
- type: 'null'
description: 'Text search: tools, apps, user email, conversation'
title: Q
description: 'Text search: tools, apps, user email, conversation'
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_WebAgentSessionSummary_'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Web Agent Sessions
/api/v1/web-agent-sessions/{session_id}:
get:
summary: Get Web Agent Session
description: One web-agent session with all of its calls.
operationId: get_web_agent_session_api_v1_web_agent_sessions__session_id__get
security:
- HTTPBearer: []
parameters:
- name: session_id
in: path
required: true
schema:
type: string
title: Session Id
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WebAgentSessionDetail'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Web Agent Sessions
components:
schemas:
WebAgentToolCallSchema:
properties:
id:
type: integer
title: Id
description: Row ID
span_id:
type: string
title: Span Id
description: OTLP span ID (hex)
tool_name:
type: string
title: Tool Name
description: Tool that was called
app_name:
anyOf:
- type: string
- type: 'null'
title: App Name
description: App or connector that owns the tool
status:
type: string
title: Status
description: 'Span status: ok, error or unset'
started_at:
type: string
format: date-time
title: Started At
description: When the call was made
ended_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Ended At
description: When the call finished, if reported
attributes:
additionalProperties:
type: string
type: object
title: Attributes
description: Other span attributes the exporter sent
type: object
required:
- id
- span_id
- tool_name
- status
- started_at
title: WebAgentToolCallSchema
PaginatedResponse_WebAgentSessionSummary_:
properties:
items:
items:
$ref: '#/components/schemas/WebAgentSessionSummary'
type: array
title: Items
description: Page of results
total:
type: integer
title: Total
description: Total number of items across all pages
page:
type: integer
title: Page
description: Current page number (1-indexed)
per_page:
type: integer
title: Per Page
description: Number of items per page
total_pages:
type: integer
title: Total Pages
description: Total number of pages
type: object
required:
- items
- total
- page
- per_page
- total_pages
title: PaginatedResponse[WebAgentSessionSummary]
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
WebAgentSessionSummary:
properties:
id:
type: string
title: Id
description: Session ID (the OTLP trace ID)
user_id:
type: string
title: User Id
description: User who reported the calls
user_email:
anyOf:
- type: string
- type: 'null'
title: User Email
description: Email of that user
agent:
type: string
title: Agent
description: Web agent the calls were made in, e.g. chatgpt, claude
conversation_id:
anyOf:
- type: string
- type: 'null'
title: Conversation Id
description: The agent's conversation ID
conversation_url:
anyOf:
- type: string
- type: 'null'
title: Conversation Url
description: Link to the conversation on the agent's site, when known
first_call_at:
type: string
format: date-time
title: First Call At
description: Time of the first call
last_call_at:
type: string
format: date-time
title: Last Call At
description: Time of the latest call
tool_call_count:
type: integer
title: Tool Call Count
description: Number of calls in the session
error_count:
type: integer
title: Error Count
description: Calls whose span status is error
app_names:
items:
type: string
type: array
title: App Names
description: Apps used, first use first
tool_names:
items:
type: string
type: array
title: Tool Names
description: Tools used, first use first
type: object
required:
- id
- user_id
- agent
- first_call_at
- last_call_at
- tool_call_count
- error_count
title: WebAgentSessionSummary
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
WebAgentSessionDetail:
properties:
id:
type: string
title: Id
description: Session ID (the OTLP trace ID)
user_id:
type: string
title: User Id
description: User who reported the calls
user_email:
anyOf:
- type: string
- type: 'null'
title: User Email
description: Email of that user
agent:
type: string
title: Agent
description: Web agent the calls were made in, e.g. chatgpt, claude
conversation_id:
anyOf:
- type: string
- type: 'null'
title: Conversation Id
description: The agent's conversation ID
conversation_url:
anyOf:
- type: string
- type: 'null'
title: Conversation Url
description: Link to the conversation on the agent's site, when known
first_call_at:
type: string
format: date-time
title: First Call At
description: Time of the first call
last_call_at:
type: string
format: date-time
title: Last Call At
description: Time of the latest call
tool_call_count:
type: integer
title: Tool Call Count
description: Number of calls in the session
error_count:
type: integer
title: Error Count
description: Calls whose span status is error
app_names:
items:
type: string
type: array
title: App Names
description: Apps used, first use first
tool_names:
items:
type: string
type: array
title: Tool Names
description: Tools used, first use first
tool_calls:
items:
$ref: '#/components/schemas/WebAgentToolCallSchema'
type: array
title: Tool Calls
description: Calls in the order they were made
type: object
required:
- id
- user_id
- agent
- first_call_at
- last_call_at
- tool_call_count
- error_count
title: WebAgentSessionDetail
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
ClientBearer:
type: http
description: Opaque ewc_ client installation credential
scheme: bearer
ServiceToken:
type: http
description: 'A SealGate service token: `sgt_acct_...` (account token) or `sgt_org_...` (org token). Mint an account token in the dashboard.'
scheme: bearer
MCPGatewayOAuth:
type: oauth2
description: OAuth 2.1 authorization-code flow (PKCE required) against the SealGate MCP gateway's authorization server. Request only the scopes an agent needs; unrequested scopes are not granted.
flows:
authorizationCode:
authorizationUrl: /oauth/authorize
tokenUrl: /oauth/token
refreshUrl: /oauth/token
scopes:
mcp: Connect to the MCP gateway and call the tools exposed by your enabled servers. Every call is still evaluated by the policy engine.
offline_access: Issue a refresh token so the client can renew access without a new browser sign-in.