Files
api-specs/idn/beta/paths/historical-identity-snapshot-summary.yaml
2022-09-02 10:59:29 -04:00

58 lines
1.7 KiB
YAML

get:
operationId: getIdentitySnapshotSummary
tags:
- Identity History
summary: Gets the summary for the event count for a specific identity
description: >-
This method gets the summary for the event count for a specific identity by month/day
Requires authorization scope of 'idn:identity-history:read'
parameters:
- in: path
name: id
schema:
type: string
required: true
description: The identity id
example: 8c190e6787aa4ed9a90bd9d5344523fb
- in: query
name: before
schema:
type: string
description: The date before which snapshot summary is required
example: '2007-03-01T13:00:00Z'
- in: query
name: interval
schema:
type: string
enum:
- day
- month
description: The interval indicating day or month. Defaults to month if not specified
- in: query
name: time-zone
schema:
type: string
description: The time zone. Defaults to UTC if not provided
example: 'UTC'
- $ref: '../../v3/parameters/limit.yaml'
- $ref: '../../v3/parameters/offset.yaml'
- $ref: '../../v3/parameters/count.yaml'
responses:
'200':
description: A summary list of identity changes in date histogram format.
content:
application/json:
schema:
type: array
items:
$ref: '../schemas/MetricResponse.yaml'
'400':
$ref: '../../v3/responses/400.yaml'
'401':
$ref: '../../v3/responses/401.yaml'
'403':
$ref: '../../v3/responses/403.yaml'
'404':
$ref: '../../v3/responses/404.yaml'
'500':
$ref: '../../v3/responses/500.yaml'