supernormal

supernormal Agent Sessions API

The Agent Sessions API from supernormal — 2 operation(s) for agent sessions.

Documentation GitHub OpenAPI

Operations 3

GET /agent_sessions Get agent sessions #

POST /agent_sessions Create an agent session #

GET /agent_sessions/{id} Get an agent session #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/supernormal:supernormal-agent-sessions-api"

All apis

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.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Supernormal Agent Sessions API
  description: Documentation for the Supernormal API
  license:
    name: MIT
  version: 1.0.0
servers:
- url: https://api.supernormal.com/api/v1
security:
- ApiKeyAuth: []
tags:
- name: Agent Sessions
paths:
  /agent_sessions:
    get:
      tags:
      - Agent Sessions
      summary: Get agent sessions
      description: Returns a given agent’s sessions
      security:
      - ApiKeyAuth:
        - agent_sessions:read
      parameters:
      - name: agent_id
        in: query
        description: The ID of the agent to get sessions for
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Agent sessions response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSession'
      operationId: getAgentSessions
      x-operation-id-source: derived
    post:
      tags:
      - Agent Sessions
      summary: Create an agent session
      security:
      - ApiKeyAuth:
        - agent_sessions:write
      parameters:
      - name: agent_id
        in: query
        description: The ID of the agent to create a session for
        required: true
        schema:
          type: string
      - name: name
        in: query
        description: The name of the user initiating the session
        required: false
        schema:
          type: string
      - name: email
        in: query
        description: The email of the user initiating the session
        required: false
        schema:
          type: string
      - name: timezone
        in: query
        description: The timezone of the user initiating the session
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Agent session response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSession'
      operationId: postAgentSessions
      x-operation-id-source: derived
  /agent_sessions/{id}:
    get:
      tags:
      - Agent Sessions
      summary: Get an agent session
      security:
      - ApiKeyAuth:
        - agent_sessions:read
      parameters:
      - name: id
        in: path
        description: The ID of the session to get
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Agent session response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSession'
      operationId: getAgentSessionsById
      x-operation-id-source: derived
components:
  schemas:
    AgentSession:
      type: object
      properties:
        id:
          description: The agent session’s ID
          type: string
        created_at:
          description: The agent session’s created at time
          type: string
        duration:
          description: The agent session’s duration
          type: integer
        started_at:
          description: The agent session’s started at time
          type: string
        done_at:
          description: The agent session’s done at time
          type: string
        meeting_url:
          description: The agent session’s meeting URL
          type: string
        status:
          description: The agent session’s status
          type: string
          enum:
          - ready
          - in_waiting_room
          - joining_call
          - in_call_ready
          - in_call_not_recording
          - in_call_recording
          - call_ended
          - done
          - fatal
          - join_request_denied
          - timeout_exceeded
          - create_error
          - recording_too_short
          - never_recorded
          - preparing
        metadata:
          description: The agent session’s metadata
          type: object
        timezone:
          description: The agent session’s timezone
          type: string
        transcription_complete:
          description: Whether the agent session’s transcription is complete
          type: boolean
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-TOKEN
      x-scopes:
        user:read: Read user information
        calendar_events:read: Read calendar events
        calendar_events:write: Write calendar events