List all audit logs

GET /v1/AuditLogs

Returns a list of your audit logs. The audit logs are returned sorted by Timestamp, with the most recent audit logs appearing first. Available to the roles: csp, reseller

Headers

  • X-Tenant string Required

    This header identifies which tenant to access with this request. This value should be an existent domain for the specified tenant.

  • Authorization string Required

    JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

    Default value is Bearer eyJ0eXAiO....

  • X-Correlation-Id string(UUID)

    This header is optional and by setting it you can correlate the audit logs made by this request.

Query parameters

  • PageNumber integer(int32)

    A cursor for pagination across multiple pages of results. The default value is 1.

  • PageSize integer(int32)

    The number of objects to be returned at each page. The size can range between 1 and 2000, and the default is 25.

  • StartDate string(date-time)

    The start date for the interval to filter the audit logs. The default value is 1 month ago.

  • EndDate string(date-time)

    The end date for the interval to filter the audit logs. The default value is current date time.

  • A string containing the operations to filter by. This string is a list separated by |. ex: CreateOrder|CreateCustomer

  • Status string

    The audit log status to filter by. Possible values: Processing, Succeded, Failed

  • Reseller string

    The reseller name to search by. This field searches for a substring so the provided string as a whole must be a present in the desired reseller name.

  • Customer string

    The customer name to search by. This field searches for a substring so the provided string as a whole must be a present in the desired customer name.

  • resellerId string(uuid)

    The reseller identifier. View the audit logs as the specified resellerId.

Responses

  • Success

    Hide response attributes Show response attributes object
    • items array[object] | null

      View model that represents an audit log.

      Hide items attributes Show items attributes object
      • id string(uuid)

        The GUID identifier for the audit log.

      • customer string | null

        The company name of the customer affected by this audit log. Can be null if no customer was affected.

      • reseller string | null

        The company name of the reseller affected by this audit log. Can be null if no reseller was affected.

      • timestamp string(date-time)

        The timestamp when the audit log was first created.

      • operation string | null

        The name of the operation for this audit log.

      • status object

        The status of the audit log. Possible values: Processing, Succeded or Failed

        Hide status attributes Show status attributes
      • user string | null

        The email of the user that initiated this audit log.

      • origin object

        The origin of the audit log. Possible values: User, API or System

        Hide origin attributes Show origin attributes
      • entityType string | null

        The type of the entity affected in this audit log.

      • entityId string(uuid) | null

        The entity identifier affected in this audit log.

      • oldValues object | null

        A dictionary with keys of value string and values of type object that contain the old property values of the entity that was affected. If the entity was created this property will be null.

        Hide oldValues attribute Show oldValues attribute
      • newValues object | null

        A dictionary with keys of value string and values of type object that contain the new property values of the entity that was affected. If the entity was deleted this property will be null.

        Hide newValues attribute Show newValues attribute
      • message string | null

        The message of the audit log.

      • correlationId string(uuid) | null

        The correlation id of the audit log.

    • A model that is used to encapsulate the parameters needed to perform pagination queries.

      Hide paginationParameters attributes Show paginationParameters attributes
    • totalPages integer(int32)

      The total number of pages available for the specified parameters and page size.

    • totalCount integer(int32)

      The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.

    • Indicates if there is a previous page.

    • Indicates if there is a next page.

    • continuationToken string | null

      The token to continue to retrieve the paginated items.

    Hide response attributes Show response attributes object
    • items array[object] | null

      View model that represents an audit log.

      Hide items attributes Show items attributes object
      • id string(uuid)

        The GUID identifier for the audit log.

      • customer string | null

        The company name of the customer affected by this audit log. Can be null if no customer was affected.

      • reseller string | null

        The company name of the reseller affected by this audit log. Can be null if no reseller was affected.

      • timestamp string(date-time)

        The timestamp when the audit log was first created.

      • operation string | null

        The name of the operation for this audit log.

      • status object

        The status of the audit log. Possible values: Processing, Succeded or Failed

        Hide status attributes Show status attributes
      • user string | null

        The email of the user that initiated this audit log.

      • origin object

        The origin of the audit log. Possible values: User, API or System

        Hide origin attributes Show origin attributes
      • entityType string | null

        The type of the entity affected in this audit log.

      • entityId string(uuid) | null

        The entity identifier affected in this audit log.

      • oldValues object | null

        A dictionary with keys of value string and values of type object that contain the old property values of the entity that was affected. If the entity was created this property will be null.

        Hide oldValues attribute Show oldValues attribute
      • newValues object | null

        A dictionary with keys of value string and values of type object that contain the new property values of the entity that was affected. If the entity was deleted this property will be null.

        Hide newValues attribute Show newValues attribute
      • message string | null

        The message of the audit log.

      • correlationId string(uuid) | null

        The correlation id of the audit log.

    • A model that is used to encapsulate the parameters needed to perform pagination queries.

      Hide paginationParameters attributes Show paginationParameters attributes
    • totalPages integer(int32)

      The total number of pages available for the specified parameters and page size.

    • totalCount integer(int32)

      The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.

    • Indicates if there is a previous page.

    • Indicates if there is a next page.

    • continuationToken string | null

      The token to continue to retrieve the paginated items.

    Hide response attributes Show response attributes object
    • items array[object] | null

      View model that represents an audit log.

      Hide items attributes Show items attributes object
      • id string(uuid)

        The GUID identifier for the audit log.

      • customer string | null

        The company name of the customer affected by this audit log. Can be null if no customer was affected.

      • reseller string | null

        The company name of the reseller affected by this audit log. Can be null if no reseller was affected.

      • timestamp string(date-time)

        The timestamp when the audit log was first created.

      • operation string | null

        The name of the operation for this audit log.

      • status object

        The status of the audit log. Possible values: Processing, Succeded or Failed

        Hide status attributes Show status attributes
      • user string | null

        The email of the user that initiated this audit log.

      • origin object

        The origin of the audit log. Possible values: User, API or System

        Hide origin attributes Show origin attributes
      • entityType string | null

        The type of the entity affected in this audit log.

      • entityId string(uuid) | null

        The entity identifier affected in this audit log.

      • oldValues object | null

        A dictionary with keys of value string and values of type object that contain the old property values of the entity that was affected. If the entity was created this property will be null.

        Hide oldValues attribute Show oldValues attribute
      • newValues object | null

        A dictionary with keys of value string and values of type object that contain the new property values of the entity that was affected. If the entity was deleted this property will be null.

        Hide newValues attribute Show newValues attribute
      • message string | null

        The message of the audit log.

      • correlationId string(uuid) | null

        The correlation id of the audit log.

    • A model that is used to encapsulate the parameters needed to perform pagination queries.

      Hide paginationParameters attributes Show paginationParameters attributes
    • totalPages integer(int32)

      The total number of pages available for the specified parameters and page size.

    • totalCount integer(int32)

      The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.

    • Indicates if there is a previous page.

    • Indicates if there is a next page.

    • continuationToken string | null

      The token to continue to retrieve the paginated items.

  • Bad Request

    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
  • 401

    Unauthorized

  • 403

    Forbidden

  • Server Error

    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
GET /v1/AuditLogs
curl \
 -X GET https://app-cloudcockpitapi-prod-01.azurewebsites.net/v1/AuditLogs \
 -H "X-Tenant: string" \
 -H "Authorization: Bearer eyJ0eXAiO..." \
 -H "X-Correlation-Id: string"
Response examples (200)
{
  "items": [
    {
      "id": "string",
      "customer": "string",
      "reseller": "string",
      "timestamp": "2024-05-04T09:42:00+00:00",
      "operation": "string",
      "status": {
        "name": "string"
      },
      "user": "string",
      "origin": {
        "name": "string"
      },
      "entityType": "string",
      "entityId": "string",
      "oldValues": {},
      "newValues": {},
      "message": "string",
      "correlationId": "string"
    }
  ],
  "paginationParameters": {
    "pageNumber": 42,
    "pageSize": 42
  },
  "totalPages": 42,
  "totalCount": 42,
  "hasPreviousPage": true,
  "hasNextPage": true,
  "continuationToken": "string"
}
Response examples (200)
{
  "items": [
    {
      "id": "string",
      "customer": "string",
      "reseller": "string",
      "timestamp": "2024-05-04T09:42:00+00:00",
      "operation": "string",
      "status": {
        "name": "string"
      },
      "user": "string",
      "origin": {
        "name": "string"
      },
      "entityType": "string",
      "entityId": "string",
      "oldValues": {},
      "newValues": {},
      "message": "string",
      "correlationId": "string"
    }
  ],
  "paginationParameters": {
    "pageNumber": 42,
    "pageSize": 42
  },
  "totalPages": 42,
  "totalCount": 42,
  "hasPreviousPage": true,
  "hasNextPage": true,
  "continuationToken": "string"
}
Response examples (400)
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}
Response examples (400)
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}
Response examples (500)
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}
Response examples (500)
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}