Umami is a privacy-first web and product analytics platform. Traffic, campaigns, behavior, conversions, and revenue in one place. No cookies, no surveillance, self-hosted or in the cloud.
TypeScript analyticsaudience-segmentationchartscohort-analysisgoogle-analyticsproduct-analyticsstatisticsuser-journeyweb-analytics
import type { ApiHttpMethod } from '@/openapi/operation';
interface OperationDescription {
summary: string;
description?: string;
}
// Hand-maintained documentation. OpenAPI generators must never overwrite this file.
// Keys use the HTTP method and OpenAPI path, including {parameter} placeholders.
export const operationDescriptions: Record<string, OperationDescription> = {
'POST /api/2fa/disable': {
summary: 'Disable two-factor authentication',
description:
'Disables two-factor authentication for the current user after verifying their password and authenticator code. Rejected when an administrator or team requires it.',
},
'POST /api/2fa/setup/cancel': {
summary: 'Cancel two-factor authentication setup',
description:
"Deletes the current user's pending setup without changing an already enabled authenticator.",
},
'POST /api/2fa/setup/confirm': {
summary: 'Confirm two-factor authentication setup',
description:
'Verifies an authenticator code, enables two-factor authentication, and returns a new set of backup codes.',
},
'POST /api/2fa/setup/initiate': {
summary: 'Set up two-factor authentication',
description:
"Starts or replaces the current user's pending setup and returns a QR code and manual setup key for an authenticator app.",
},
'GET /api/2fa/status': {
summary: 'Get two-factor authentication status',
description:
'Returns whether two-factor authentication is enabled, configured, or required for the current user, including the reason it is required.',
},
'POST /api/2fa/verify': {
summary: 'Complete two-factor sign-in',
description:
'Exchanges a partial sign-in token and a valid authenticator or backup code for a full authentication token and user details.',
},
'POST /api/admin/2fa/global': {
summary: 'Set the two-factor requirement for everyone',
description:
'Enables or disables the installation-wide requirement for users to set up two-factor authentication.',
},
'GET /api/admin/teams': {
summary: 'List all teams',
description:
'Returns a paginated list of teams with member details and website and member counts for administration.',
},
'POST /api/admin/teams/{teamId}/2fa': {
summary: "Set a team's two-factor requirement",
description:
'Enables or disables the requirement for members of the specified team to use two-factor authentication.',
},
'GET /api/admin/users': {
summary: 'List all users',
description:
'Returns a paginated list of users and their website counts for administration, excluding passwords.',
},
'DELETE /api/admin/users/{userId}/2fa': {
summary: "Reset a user's two-factor authentication",
description:
"Removes the specified user's authenticator setup, backup codes, used-code history, and failed-attempt limits so they can set up authentication again.",
},
'GET /api/admin/users/{userId}/2fa': {
summary: "Get a user's two-factor status",
description: 'Returns whether two-factor authentication is enabled for the specified user.',
},
'POST /api/admin/users/{userId}/2fa': {
summary: "Set a user's two-factor requirement",
description:
'Enables or disables the requirement for the specified user to set up two-factor authentication.',
},
'GET /api/admin/websites': {
summary: 'List all websites',
description:
'Returns a paginated, searchable list of websites across users and teams for administration.',
},
'POST /api/auth/login': {
summary: 'Log in',
description:
'Authenticates a user with a username and password. Users with two-factor authentication receive a short-lived partial token to complete sign-in.',
},
'POST /api/auth/logout': {
summary: 'Log out',
description:
'Ends the current authentication session by removing its stored token when Redis-backed sessions are enabled.',
},
'POST /api/auth/sso': {
summary: 'Create a single sign-on token',
description:
'Returns the authenticated user and a new token valid for 24 hours. Requires Redis-backed authentication.',
},
'GET /api/auth/subscription': {
summary: 'Get subscription details',
description:
'Returns subscription and feature availability for the current user or a specified team the user can access.',
},
'POST /api/auth/verify': {
summary: 'Verify the current sign-in',
description:
'Validates the current authentication credentials and returns the user and their team memberships.',
},
'POST /api/batch': {
summary: 'Send a batch of tracking requests',
description:
'Processes up to 500 tracking payloads and returns processed and failed counts, individual error details, and a tracking cache token.',
},
'GET /api/boards': {
summary: 'List my boards',
description:
"Returns a paginated list of the current user's boards, with search and sorting options.",
},
'POST /api/boards': {
summary: 'Create a board',
description:
'Creates a board with a name, type, and configuration, optionally assigned to a team. Validates access to its referenced resources and reports.',
},
'DELETE /api/boards/{boardId}': {
summary: 'Delete a board',
description: "Deletes the specified board after checking the caller's permission to remove it.",
},
'GET /api/boards/{boardId}': {
summary: 'Get a board',
description: 'Returns the specified board and its configuration.',
},
'POST /api/boards/{boardId}': {
summary: 'Update a board',
description:
"Updates a board's name, description, or configuration and validates the resources and reports it references.",
},
'POST /api/boards/{boardId}/clone': {
summary: 'Clone a board',
description:
'Creates a copy of a board with optional changes to its name, description, and configuration. Removes invalid report references from the copy.',
},
'GET /api/boards/{boardId}/shares': {
summary: 'List shares for a board',
description: 'Returns a paginated list of shares for the specified board.',
},
'POST /api/boards/{boardId}/shares': {
summary: 'Create a share for a board',
description: 'Creates a named share for the specified board with optional parameters.',
},
'GET /api/config': {
summary: 'Get application configuration',
description:
'Returns public application settings, including deployment mode, feature availability, and tracker and resource URLs.',
},
'GET /api/dashboard': {
summary: 'Get my dashboard',
description: "Returns the current user's personal dashboard board and its configuration.",
},
'POST /api/dashboard': {
summary: 'Save my dashboard',
description:
"Creates or updates the current user's personal dashboard with the supplied name, description, and configuration.",
},
'GET /api/heartbeat': {
summary: 'Check application availability',
description:
'Returns a simple success response to confirm that the application can serve requests.',
},
'GET /api/links': {
summary: 'List my links',
description:
"Returns a paginated list of the current user's tracked links, with search and sorting options.",
},
'POST /api/links': {
summary: 'Create a tracked link',
description:
'Creates a tracked link with a name, destination URL, and slug, optionally assigned to a team.',
},
'DELETE /api/links/{linkId}': {
summary: 'Delete a tracked link',
description:
"Deletes the specified tracked link after checking the caller's permission to remove it.",
},
'GET /api/links/{linkId}': {
summary: 'Get a tracked link',
description: 'Returns the specified tracked link, including its destination URL and slug.',
},
'POST /api/links/{linkId}': {
summary: 'Update a tracked link',
description: "Updates a tracked link's name, destination URL, or slug.",
},
'GET /api/links/{linkId}/shares': {
summary: 'List shares for a link',
description: 'Returns a paginated list of shares for the specified link.',
},
'POST /api/links/{linkId}/shares': {
summary: 'Create a share for a link',
description: 'Creates a named share for the specified link with optional parameters.',
},
'GET /api/links/charts': {
summary: 'Get visitor charts for links',
description:
'Returns visitor totals and chart data for the requested links the caller can view, within the selected date range.',
},
'GET /api/me': {
summary: 'Get my authentication details',
description:
'Returns the current authentication context, including the authenticated user or share credentials.',
},
'GET /api/me/api-keys': {
summary: 'List my API keys',
description:
"Returns metadata for the current user's API keys. Available on self-hosted installations.",
},
'POST /api/me/api-keys': {
summary: 'Create an API key',
description:
'Creates a named API key for the current user and returns its secret value. Available on self-hosted installations.',
},
'DELETE /api/me/api-keys/{keyId}': {
summary: 'Delete an API key',
description:
'Deletes an API key belonging to the current user, revoking its access. Available on self-hosted installations.',
},
'POST /api/me/password': {
summary: 'Change my password',
description: 'Verifies the current password and replaces it with the supplied new password.',
},
'GET /api/me/teams': {
summary: 'List my team memberships',
description:
'Returns a paginated list of teams the current user belongs to, with sorting options.',
},
'GET /api/me/websites': {
summary: 'List my websites',
description:
"Returns a paginated list of the current user's websites, optionally including websites accessible through team membership.",
},
'GET /api/pixels': {
summary: 'List my tracking pixels',
description:
"Returns a paginated list of the current user's tracking pixels, with search and sorting options.",
},
'POST /api/pixels': {
summary: 'Create a tracking pixel',
description: 'Creates a tracking pixel with a name and slug, optionally assigned to a team.',
},
'DELETE /api/pixels/{pixelId}': {
summary: 'Delete a tracking pixel',
description:
"Deletes the specified tracking pixel after checking the caller's permission to remove it.",
},
'GET /api/pixels/{pixelId}': {
summary: 'Get a tracking pixel',
description: 'Returns the specified tracking pixel and its configuration.',
},
'POST /api/pixels/{pixelId}': {
summary: 'Update a tracking pixel',
description: "Updates a tracking pixel's name or slug.",
},
'GET /api/pixels/{pixelId}/shares': {
summary: 'List shares for a tracking pixel',
description: 'Returns a paginated list of shares for the specified tracking pixel.',
},
'POST /api/pixels/{pixelId}/shares': {
summary: 'Create a share for a tracking pixel',
description: 'Creates a named share for the specified tracking pixel with optional parameters.',
},
'GET /api/pixels/charts': {
summary: 'Get visitor charts for tracking pixels',
description:
'Returns visitor totals and chart data for the requested pixels the caller can view, within the selected date range.',
},
'GET /api/realtime/{websiteId}': {
summary: 'Get real-time website activity',
description:
'Returns recent website activity and visitor data for the real-time view, applying the supplied filters.',
},
'POST /api/record': {
summary: 'Send session recordings or heatmap data',
description:
'Stores session replay events or heatmap clicks and scrolls for a website, using a valid tracking cache token to identify the session and visit.',
},
'GET /api/scripts/telemetry': {
summary: 'Get the installation telemetry script',
description:
'Returns JavaScript that sends the application version through a telemetry pixel, or an inactive script when telemetry is disabled.',
},
'POST /api/send': {
summary: 'Send tracking data',
description:
'Collects a pageview, custom event, visitor identification, or performance payload and returns session information and a tracking cache token when accepted.',
},
'POST /api/share': {
summary: 'Create a share',
description:
'Creates a named share for a website, board, link, or pixel with parameters and an optional custom slug.',
},
'GET /api/share/{slug}': {
summary: 'Open a share by its slug',
description:
'Resolves a public share slug and returns its resource references, parameters, and an access token scoped to the shared resources.',
},
'DELETE /api/share/id/{shareId}': {
summary: 'Delete a share',
description:
'Deletes the specified share after checking permission to delete shares for its resource.',
},
'GET /api/share/id/{shareId}': {
summary: 'Get a share',
description:
"Returns a share's configuration by its ID after checking access to the shared resource.",
},
'POST /api/share/id/{shareId}': {
summary: 'Update a share',
description: "Updates the specified share's name, slug, and parameters.",
},
'GET /api/teams': {
summary: 'List my teams',
description:
'Returns a paginated list of teams the current user belongs to, with sorting options.',
},
'POST /api/teams': {
summary: 'Create a team',
description:
'Creates a team with an access code and an owner. Administrators can specify a different user as the owner.',
},
'DELETE /api/teams/{teamId}': {
summary: 'Delete a team',
description: "Deletes the specified team after checking the caller's permission to remove it.",
},
'GET /api/teams/{teamId}': {
summary: 'Get a team',
description: "Returns the specified team's details, including its members.",
},
'POST /api/teams/{teamId}': {
summary: 'Update a team',
description: "Updates the specified team's name or access code.",
},
'GET /api/teams/{teamId}/boards': {
summary: "List a team's boards",
description:
'Returns a paginated list of boards belonging to the specified team, with search and sorting options.',
},
'GET /api/teams/{teamId}/links': {
summary: "List a team's links",
description:
'Returns a paginated list of tracked links belonging to the specified team, with search and sorting options.',
},
'GET /api/teams/{teamId}/pixels': {
summary: "List a team's tracking pixels",
description:
'Returns a paginated list of tracking pixels belonging to the specified team, with search and sorting options.',
},
'GET /api/teams/{teamId}/users': {
summary: 'List team members',
description:
'Returns a paginated list of members of the specified team, including usernames and membership details.',
},
'POST /api/teams/{teamId}/users': {
summary: 'Add a team member',
description: 'Adds an existing user to the specified team with the supplied team role.',
},
'DELETE /api/teams/{teamId}/users/{userId}': {
summary: 'Remove a team member',
description:
"Removes a user's membership from the specified team, subject to team role and ownership restrictions.",
},
'GET /api/teams/{teamId}/users/{userId}': {
summary: 'Get a team member',
description: "Returns the specified user's membership details for a team.",
},
'POST /api/teams/{teamId}/users/{userId}': {
summary: "Change a team member's role",
description:
"Updates a user's role in the specified team, subject to the caller's role and permissions.",
},
'GET /api/teams/{teamId}/websites': {
summary: "List a team's websites",
description:
'Returns a paginated list of websites belonging to the specified team, with search and sorting options.',
},
'POST /api/teams/join': {
summary: 'Join a team',
description: "Adds the current user to a team as a member using the team's access code.",
},
'POST /api/users': {
summary: 'Create a user',
description: 'Creates a user account with the supplied username, password, and role.',
},
'DELETE /api/users/{userId}': {
summary: 'Delete a user',
description:
'Deletes the specified user account. The current user cannot delete their own account through this operation.',
},
'GET /api/users/{userId}': {
summary: 'Get a user',
description:
'Returns details for the specified user account when the caller has permission to view it.',
},
'POST /api/users/{userId}': {
summary: 'Update a user',
description: "Updates a user's password. Administrators can also change the username and role.",
},
'GET /api/users/{userId}/teams': {
summary: "List a user's teams",
description:
'Returns a paginated list of teams for the specified user. Available to that user and administrators.',
},
'GET /api/users/{userId}/websites': {
summary: "List a user's websites",
description:
"Returns a paginated list of the specified user's websites, optionally including team access. Available to that user and administrators.",
},
'GET /api/websites': {
summary: 'List websites',
description:
"Returns a paginated list of the current user's websites, optionally including websites accessible through team membership.",
},
'POST /api/websites': {
summary: 'Create a website',
description:
'Creates a website with a name and domain, optionally assigning it to a team and creating a share.',
},
'DELETE /api/websites/{websiteId}': {
summary: 'Delete a website',
description:
"Deletes the specified website after checking the caller's permission to remove it.",
},
'GET /api/websites/{websiteId}': {
summary: 'Get a website',
description: "Returns the specified website's details and configuration.",
},
'POST /api/websites/{websiteId}': {
summary: 'Update a website',
description: "Updates a website's name, domain, sharing settings, or recording configuration.",
},
'GET /api/websites/{websiteId}/active': {
summary: 'Get active website visitors',
description: 'Returns the number of visitors active on the website in the last few minutes.',
},
'GET /api/websites/{websiteId}/annotations': {
summary: 'List website annotations',
description:
'Returns a paginated list of dated notes for the website, optionally filtered by date range or search text.',
},
'POST /api/websites/{websiteId}/annotations': {
summary: 'Create a website annotation',
description:
'Adds a dated note to the website, optionally marking it as an all-day annotation.',
},
'DELETE /api/websites/{websiteId}/annotations/{annotationId}': {
summary: 'Delete a website annotation',
description: 'Deletes the specified dated note from the website.',
},
'GET /api/websites/{websiteId}/annotations/{annotationId}': {
summary: 'Get a website annotation',
description: 'Returns the date, all-day setting, and note for a specific website annotation.',
},
'POST /api/websites/{websiteId}/annotations/{annotationId}': {
summary: 'Update a website annotation',
description: 'Changes the date, all-day setting, and note for a website annotation.',
},
'GET /api/websites/{websiteId}/daterange': {
summary: "Get the website's available date range",
description: 'Returns the earliest and latest recorded event dates for the website.',
},
'GET /api/websites/{websiteId}/event-data': {
summary: 'List events with custom properties',
description:
"Returns a page of events in the selected date range, grouping each event's custom property records together.",
},
'GET /api/websites/{websiteId}/event-data-pivot': {
summary: 'List event properties in table form',
description:
'Returns a page of occurrences of the specified event, with event details and property keys and values grouped into one row per occurrence.',
},
'GET /api/websites/{websiteId}/event-data-pivot/array-series': {
summary: 'Get event array values over time',
description:
'Counts individual values in an array property for the specified event, grouped by value and time interval.',
},
'GET /api/websites/{websiteId}/event-data-pivot/date-series': {
summary: 'Get the distribution of event date values',
description:
"Counts occurrences of dates stored in the specified event property, grouping by the property's date value within the selected event date range.",
},
'GET /api/websites/{websiteId}/event-data-pivot/numeric-series': {
summary: 'Get numeric event properties over time',
description:
'Returns the sum, average, or count of a numeric property for the specified event, grouped by time interval.',
},
'GET /api/websites/{websiteId}/event-data-pivot/numeric-stats': {
summary: 'Get numeric event property statistics',
description:
'Returns the total, average, median, minimum, and maximum of the specified numeric event property for the selected date range and filters.',
},
'GET /api/websites/{websiteId}/event-data-pivot/property-series': {
summary: 'Get event property values over time',
description:
'Counts occurrences of string values in the specified event property, grouped by value and time interval.',
},
'GET /api/websites/{websiteId}/event-data/{eventId}': {
summary: "Get an event's custom properties",
description:
'Returns the custom property records, data types, and values attached to a specific event.',
},
'GET /api/websites/{websiteId}/event-data/events': {
summary: 'Summarize properties by event',
description:
'Returns property names, types, and counts grouped by event name. When an event is specified, also groups by property value.',
},
'GET /api/websites/{websiteId}/event-data/fields': {
summary: 'List event property fields',
description:
'Returns property names, data types, and counts for the selected date range, optionally restricted to an event name.',
},
'GET /api/websites/{websiteId}/event-data/properties': {
summary: 'List event property usage',
description:
'Returns event names and their custom property names, data types, and record counts for the selected date range and filters.',
},
'GET /api/websites/{websiteId}/event-data/stats': {
summary: 'Get event property totals',
description:
'Returns counts of events with custom data, distinct property names, and property records for the selected date range and filters.',
},
'GET /api/websites/{websiteId}/event-data/values': {
summary: 'List event property values',
description:
'Returns values and their occurrence counts for a custom event property, optionally restricted by event name and data type.',
},
'GET /api/websites/{websiteId}/events': {
summary: 'List tracked events',
description:
'Returns a page of pageviews and custom events in the date range, newest first. Supports filtering by event name and searching event details.',
},
'GET /api/websites/{websiteId}/events/series': {
summary: 'Get custom event counts over time',
description:
'Returns counts grouped by event name and time interval, optionally limited to the most frequent event names.',
},
'GET /api/websites/{websiteId}/events/stats': {
summary: 'Get website event statistics',
description:
'Returns website event totals for the selected date range and filters, including totals for the comparison period.',
},
'GET /api/websites/{websiteId}/export': {
summary: 'Export website analytics',
description:
'Returns a base64-encoded ZIP archive containing CSV exports of events, pages, referrers, browsers, operating systems, devices, and countries.',
},
'GET /api/websites/{websiteId}/metrics': {
summary: 'Get ranked website metrics',
description:
'Returns the most frequent values for a dimension such as pages, referrers, countries, browsers, campaigns, or events. Counts pageviews or events for activity dimensions and unique visitors for visitor dimensions.',
},
'GET /api/websites/{websiteId}/metrics/expanded': {
summary: 'Get detailed website metrics',
description:
'Returns additional analytics for the selected page, event, visitor, or channel dimension, using the supplied date range and filters.',
},
'GET /api/websites/{websiteId}/pageviews': {
summary: 'Get pageviews and sessions over time',
description:
'Returns pageviews and sessions grouped by the requested time interval and timezone, including a comparison period when requested.',
},
'GET /api/websites/{websiteId}/recorder': {
summary: 'Get website recording settings',
description:
'Returns public replay and heatmap settings, including sampling, masking, and duration limits. Returns disabled status when recording is unavailable.',
},
'GET /api/websites/{websiteId}/replays': {
summary: 'List website session replays',
description:
'Returns a paginated list of recorded sessions for the website, applying date, replay, and search filters.',
},
'GET /api/websites/{websiteId}/replays/{replayId}': {
summary: 'Get a session replay recording',
description:
'Returns the merged recording events, session details, and event and chunk counts for a replay, with optional stopping points by timestamp, chunk, or event index.',
},
'GET /api/websites/{websiteId}/replays/saved': {
summary: 'List saved session replays',
description: 'Returns a paginated, searchable list of replays saved for the website.',
},
'GET /api/websites/{websiteId}/replays/saved/{replayId}': {
summary: 'Check whether a replay is saved',
description: "Returns whether the specified replay is in the website's saved replays.",
},
'POST /api/websites/{websiteId}/replays/saved/{replayId}': {
summary: 'Save or unsave a session replay',
description:
"Adds a replay to the website's saved replays with an optional name, or removes it when isSaved is false.",
},
'POST /api/websites/{websiteId}/reset': {
summary: 'Reset website analytics',
description:
"Clears the website's collected analytics data while keeping the website configuration.",
},
'GET /api/websites/{websiteId}/revenue/chart': {
summary: 'Get website revenue over time',
description:
'Returns revenue chart data for the selected currency, date range, and website filters.',
},
'GET /api/websites/{websiteId}/revenue/metrics': {
summary: 'Get website revenue by dimension',
description:
'Returns revenue grouped by the requested dimension, such as country or referrer, for the selected currency and date range.',
},
'GET /api/websites/{websiteId}/revenue/sessions': {
summary: 'List sessions with revenue',
description:
'Returns a paginated list of sessions with revenue in the selected currency and date range, applying website and search filters.',
},
'GET /api/websites/{websiteId}/revenue/stats': {
summary: 'Get website revenue totals',
description:
'Returns revenue summary statistics for the selected currency and date range, including totals for the comparison period.',
},
'GET /api/websites/{websiteId}/segments': {
summary: 'List website segments and cohorts',
description:
'Returns saved segments or cohorts for the website, filtered by the requested type and search text.',
},
'POST /api/websites/{websiteId}/segments': {
summary: 'Create a website segment or cohort',
description:
'Saves a named segment or cohort with its type and filter parameters for the website.',
},
'DELETE /api/websites/{websiteId}/segments/{segmentId}': {
summary: 'Delete a website segment or cohort',
description: 'Deletes the specified saved segment or cohort from the website.',
},
'GET /api/websites/{websiteId}/segments/{segmentId}': {
summary: 'Get a website segment or cohort',
description: 'Returns a saved segment or cohort and its filter parameters for the website.',
},
'POST /api/websites/{websiteId}/segments/{segmentId}': {
summary: 'Update a website segment or cohort',
description: "Updates a saved segment or cohort's type, name, and filter parameters.",
},
'GET /api/websites/{websiteId}/session-data-pivot': {
summary: 'List session properties in table form',
description:
'Returns a page of sessions matching the selected property and filters, with the latest property keys and values grouped into one row per session.',
},
'GET /api/websites/{websiteId}/session-data/array-series': {
summary: 'Get session array values over time',
description:
'Counts distinct sessions for individual values in an array property, grouped by value and time interval.',
},
'GET /api/websites/{websiteId}/session-data/date-series': {
summary: 'Get the distribution of session date values',
description:
'Counts distinct sessions by dates stored in the specified custom property, using the selected date range and filters.',
},
'GET /api/websites/{websiteId}/session-data/numeric-series': {
summary: 'Get numeric session properties over time',
description:
'Returns the sum, average, or count of a numeric session property, grouped by time interval for the selected date range and filters.',
},
'GET /api/websites/{websiteId}/session-data/numeric-stats': {
summary: 'Get numeric session property statistics',
description:
'Returns the total, average, median, minimum, and maximum of the specified numeric session property for the selected date range and filters.',
},
'GET /api/websites/{websiteId}/session-data/properties': {
summary: 'List session property usage',
description:
'Returns custom session property names, data types, and distinct session counts, optionally restricted to sessions with a selected property.',
},
'GET /api/websites/{websiteId}/session-data/property-series': {
summary: 'Get session property values over time',
description:
'Counts distinct sessions for string values in a custom property, grouped by value and time interval.',
},
'GET /api/websites/{websiteId}/session-data/stats': {
summary: 'Get activity by session property',
description:
'Returns session, visit, pageview, event, and total activity counts grouped by values of the specified session property.',
},
'GET /api/websites/{websiteId}/session-data/values': {
summary: 'List session property values',
description:
'Returns custom session property values and their occurrence counts, optionally filtered by property name and data type.',
},
'GET /api/websites/{websiteId}/sessions': {
summary: 'List visitor sessions',
description:
'Returns a page of visitor sessions in the date range, newest first. Search matches distinct ID, city, browser, operating system, or device.',
},
'DELETE /api/websites/{websiteId}/sessions/{sessionId}': {
summary: 'Delete a visitor session',
description:
'Deletes the specified session and its associated analytics data. Available on installations using only a relational database.',
},
'GET /api/websites/{websiteId}/sessions/{sessionId}': {
summary: 'Get a visitor session',
description:
'Returns details for a website session, including linked visitor identities and whether session deletion is available to the caller.',
},
'GET /api/websites/{websiteId}/sessions/{sessionId}/activity': {
summary: "Get a visitor's session activity",
description:
'Returns activity for the specified session and sessions linked by visitor identity, using the requested date range and optional distinct ID.',
},
'GET /api/websites/{websiteId}/sessions/{sessionId}/properties': {
summary: "Get a session's custom properties",
description:
'Returns custom property records, data types, and values for the specified website session.',
},
'GET /api/websites/{websiteId}/sessions/{sessionId}/replays': {
summary: "List a visitor's session replays",
description:
'Returns a paginated, searchable list of recordings for the specified website session.',
},
'GET /api/websites/{websiteId}/sessions/stats': {
summary: 'Get visitor session statistics',
description:
'Returns aggregate session metrics for the website over the selected date range and filters.',
},
'GET /api/websites/{websiteId}/sessions/weekly': {
summary: 'Get traffic by weekday and hour',
description:
'Returns distinct visitor counts grouped by day of the week and hour in the selected timezone and date range.',
},
'GET /api/websites/{websiteId}/shares': {
summary: 'List shares for a website',
description: 'Returns a paginated list of shares for the specified website.',
},
'POST /api/websites/{websiteId}/shares': {
summary: 'Create a share for a website',
description: 'Creates a named share for the specified website with optional parameters.',
},
'GET /api/websites/{websiteId}/stats': {
summary: 'Get website summary statistics',
description:
'Returns pageviews, unique visitors, visits, bounces, and total time on site for the selected date range and comparison period.',
},
'POST /api/websites/{websiteId}/transfer': {
summary: 'Transfer website ownership',
description:
'Transfers the specified website to another user or team after checking permission for the destination.',
},
'GET /api/websites/{websiteId}/values': {
summary: 'List website filter values',
description:
'Returns available values for a website filter, including saved segments or cohorts when requested, to populate filter choices.',
},
'GET /api/websites/charts': {
summary: 'Get visitor charts for websites',
description:
'Returns visitor totals and chart data for the requested websites the caller can view, within the selected date range.',
},
} satisfies Partial<Record<`${Uppercase<ApiHttpMethod>} /${string}`, OperationDescription>>;