Skip to main content

Get User History

POST 
https://$CUSTOM-DOMAIN/management/v1/users/:userId/changes/_search

Returns a list of changes/events that have happened on the user. It's the history of the user. Make sure to send a limit.

Request​

Path Parameters

    userId stringrequired

Header Parameters

    x-zitadel-orgid string

    The default is always the organization of the requesting user. If you like to get users of another organization include the header. Make sure the user has permission to access the requested data.

Body

required

    query

    object

    Filter possibility for the changes/history of an Object.

    sequence uint64

    sequence represents the order of events. It's always counting

    limit int64

    Maximum amount of events returned. The default is set to 1000 in https://github.com/zitadel/zitadel/blob/new-eventstore/cmd/zitadel/startup.yaml. If no limit is set or the limit exceeds the maximum configured ZITADEL will throw an error. If no limit is present the default is taken.

    asc boolean

    default is descending

Responses​

A successful response.

Schema

    result

    object[]

  • Array [

    • changeDate date-time

    the creation date of an event

    eventType

    object

    key string
    localizedMessage string
    sequence uint64
    editorId string

    the id of the user who created the event

    editorDisplayName string

    the display name of the editor

    resourceOwnerId string

    the organization the event belongs to

    editorPreferredLoginName string

    the preferred login name of the editor

    editorAvatarUrl string

    avatar URL of the editor

  • ]

curl -L 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/changes/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "query": {
    "sequence": "2",
    "limit": 20,
    "asc": true
  }
}'
Request Collapse all
Base URL
https://$CUSTOM-DOMAIN/management/v1
Auth
Parameters
— pathrequired
— header
Body required
{
  "query": {
    "sequence": "2",
    "limit": 20,
    "asc": true
  }
}
ResponseClear

Click the Send API Request button above and see the response here!