Skip to main content

Application History​

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

Path Parameters
  • projectId string required
  • appId string required
Query Parameters
  • query.sequence uint64

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

  • query.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.

  • query.asc boolean

    default is descending

Header Parameters
  • x-zitadel-orgid string

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

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

  • ]
POST /projects/:projectId/apps/:appId/changes/_search

Authorization

type: oauth2flow: authorizationCodescopes: openid,urn:zitadel:iam:org:project:id:zitadel:aud

Request

Base URL
https://$ZITADEL_DOMAIN/management/v1
Bearer Token
projectId — path required
appId — path required
query.sequence — query
query.limit — query
query.asc — query
x-zitadel-orgid — header
Accept
curl -L -X POST 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/apps/:appId/changes/_search' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'