Audit Logs

List organization audit logs

Changed on

Retrieve audit logs for a specific organization with optional filtering and pagination.

get/organizations/{orgId}/audit-logs

Request

  • Base URL
    https://api.render.com/v1
  • Auth
    HTTP bearer

Query parameters

startTimestring date-time
Example:2023-01-01T00:00:00Z

Start time for filtering audit logs (ISO 8601 format)

endTimestring date-time
Example:2023-12-31T23:59:59Z

End time for filtering audit logs (ISO 8601 format)

cursorstring

The position in the result list to start from when fetching paginated results. For details, see Pagination.

limitinteger

Defaults to 20

The maximum number of audit log items to return. For details, see Pagination.

Parameters

#/paths/~1logs/get/parameters/3 (unresolved $ref)

Response

OK

cursorstring required

Example response

[
  {
    "auditLog": {
      "id": "aud-123456789",
      "timestamp": "2023-10-01T12:00:00Z",
      "event": "CreateServerEvent",
      "status": "success",
      "actor": {
        "type": "user",
        "email": "user@example.com",
        "id": "usr-123456789"
      },
      "metadata": {
        "service": "srv-123456789",
        "field": "env_vars"
      }
    }
  }
]

Changes

    • warning

      added the new CreateBuildSourceEvent enum value to the // response property for the response status

    • warning

      added the new CreateSavedSearchEvent enum value to the // response property for the response status

    • warning

      added the new DeleteBuildSourceEvent enum value to the // response property for the response status

    • warning

      added the new DeleteSavedSearchEvent enum value to the // response property for the response status

    • warning

      added the new LinkBuildSourceEnvGroupEvent enum value to the // response property for the response status

    • warning

      added the new UnlinkBuildSourceEnvGroupEvent enum value to the // response property for the response status

    • warning

      added the new UpdateBuildSourceEvent enum value to the // response property for the response status

    • warning

      added the new UpdateOrgPaymentMethodEvent enum value to the // response property for the response status

    • warning

      added the new UpdateServiceBuildSourceEvent enum value to the // response property for the response status

    • warning

      added the new UpdateWorkspacePaymentMethodEvent enum value to the // response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the CreateArtifactSourceEvent enum value from the // response property for the response status